> ## Documentation Index
> Fetch the complete documentation index at: https://developer.fieldnode.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Part

> List multiple parts with pagination.



## OpenAPI

````yaml /api/openapi.json get /v1/parts
openapi: 3.1.0
info:
  title: Fieldnode API
  version: v1
  contact:
    name: Support
    url: https://fieldnode.com
    email: support@fieldnode.com
servers:
  - url: https://api.lab.fieldnode.dev
    description: Lab
    variables: {}
  - url: https://api.sandbox.fieldnode.dev
    description: Sandbox
    variables: {}
  - url: https://api.fieldnode.app
    description: Production
    variables: {}
security:
  - BearerAuth: []
tags:
  - name: Process
  - name: Standard
  - name: Material
  - name: Org
  - name: Upload
  - name: Part
  - name: Factory
  - name: Category
  - name: Criticality
  - name: Rfq
  - name: Offer
paths:
  /v1/parts:
    get:
      tags:
        - Part
      summary: List Part
      description: List multiple parts with pagination.
      operationId: listParts
      parameters:
        - $ref: '#/components/parameters/PaginatedListProps.page'
        - $ref: '#/components/parameters/PaginatedListProps.pageSize'
        - name: view
          in: query
          required: false
          description: View mode for listing parts.
          schema:
            type: string
            enum:
              - CONSUMER
              - IP_OWNER
            default: CONSUMER
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                type: object
                required:
                  - items
                  - hasMore
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/Part'
                    description: List of items.
                  hasMore:
                    type: boolean
                    description: Whether there are more items to fetch.
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  parameters:
    PaginatedListProps.page:
      name: page
      in: query
      required: false
      description: Page number for pagination, starting at 1.
      schema:
        type: integer
        format: int32
        minimum: 1
        default: 1
      explode: false
    PaginatedListProps.pageSize:
      name: pageSize
      in: query
      required: false
      description: Page size for pagination.
      schema:
        type: integer
        format: int32
        minimum: 1
        maximum: 50
        default: 10
      explode: false
  schemas:
    Part:
      type: object
      required:
        - id
        - title
        - serialId
        - ipOwnerId
        - internal
        - published
        - requireSubscription
        - keywords
        - createdTime
        - modifiedTime
        - customFields
      properties:
        id:
          type: string
          description: Part id.
        parentId:
          type: string
          description: Part parent id (if versioned).
        title:
          type: string
          description: Title of the part.
        versionName:
          type: string
          description: Version name of the part.
        serialId:
          type: string
          description: Part serial id.
        ipOwnerId:
          type: string
          description: IP owner organization id.
        internal:
          type: boolean
          description: Whether the part is internal.
        externalRef:
          type: string
          description: External reference for the part.
        description:
          type: string
          description: Description of the part.
        published:
          type: boolean
          description: Whether the part is published.
        requireSubscription:
          type: boolean
          description: Whether the part requires a subscription.
        keywords:
          type: array
          items:
            type: string
          description: Keywords of the part.
        createdTime:
          type: string
          format: date-time
          description: Time when the part was created.
        modifiedTime:
          type: string
          format: date-time
          description: Time when the part was modified.
        processId:
          type: string
          description: Process id of the part.
        materialId:
          type: string
          description: Material id of the part.
        standardIds:
          type: array
          items:
            type: string
          description: Standard ids.
        criticalityIds:
          type: array
          items:
            type: string
          description: Criticality ids.
        categoryIds:
          type: array
          items:
            type: string
          description: Category ids.
        unspscCategoryIds:
          type: array
          items:
            type: string
          description: UNSPSC category ids.
        dimensions:
          $ref: '#/components/schemas/Dimensions'
          description: Physical dimensions of the part.
        boundingBox:
          $ref: '#/components/schemas/BoundingBox'
          description: Bounding box measures (x/y/z).
        customFields:
          type: array
          items:
            $ref: '#/components/schemas/CustomFieldSelection'
          description: |-
            Custom dropdown selections for this part.
            Populated only for parts owned by the caller's organisation;
            empty for other organisations' parts.
    Error:
      type: object
      required:
        - status
        - message
      properties:
        status:
          type: integer
        message:
          type: string
    Dimensions:
      type: object
      properties:
        angle:
          type: number
          format: double
          description: Angle.
        depth:
          type: number
          format: double
          description: Depth.
        width:
          type: number
          format: double
          description: Width.
        height:
          type: number
          format: double
          description: Height.
        length:
          type: number
          format: double
          description: Length.
        radius:
          type: number
          format: double
          description: Radius.
        volume:
          type: number
          format: double
          description: Volume.
        weight:
          type: number
          format: double
          description: Weight.
        tolerance:
          type: number
          format: double
          description: Tolerance.
        threadSize:
          type: number
          format: double
          description: Thread size.
        chamferSize:
          type: number
          format: double
          description: Chamfer size.
        surfaceArea:
          type: number
          format: double
          description: Surface area.
        filletRadius:
          type: number
          format: double
          description: Fillet radius.
        holeDiameter:
          type: number
          format: double
          description: Hole diameter.
        innerDiameter:
          type: number
          format: double
          description: Inner diameter.
        outerDiameter:
          type: number
          format: double
          description: Outer diameter.
        wallThickness:
          type: number
          format: double
          description: Wall thickness.
        holeChamferSize:
          type: number
          format: double
          description: Hole chamfer size.
      description: Geometric dimensions extracted from the part. Absent values are omitted.
    BoundingBox:
      type: object
      properties:
        x:
          type: number
          format: double
          description: X dimension.
        'y':
          type: number
          format: double
          description: Y dimension.
        z:
          type: number
          format: double
          description: Z dimension.
      description: Bounding box dimensions.
    CustomFieldSelection:
      type: object
      required:
        - dropdownId
        - dropdownLabel
        - multiselect
        - selectedOptions
      properties:
        dropdownId:
          type: string
          description: Dropdown id.
        dropdownLabel:
          type: string
          description: Dropdown display label.
        multiselect:
          type: boolean
          description: Whether the dropdown allows multiple selections.
        selectedOptions:
          type: array
          items:
            $ref: '#/components/schemas/CustomFieldOption'
          description: The options currently selected for this part.
      description: A custom dropdown with its currently selected options for a part.
    CustomFieldOption:
      type: object
      required:
        - id
        - label
        - value
      properties:
        id:
          type: string
          description: Option id.
        label:
          type: string
          description: Display label.
        value:
          type: string
          description: Machine-readable value.
      description: A single option within a custom dropdown.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Token

````