---
title: "List Parts"
method: GET
path: "/parts"
tags: ["Parts"]
---

# List Parts

`GET /parts`

## Request

- Base URL: `https://secure.fleetio.com/api`
- URL: `https://secure.fleetio.com/api/parts`
- Auth: API key in header `Authorization` and API key in header `Account-Token`
- TypeScript: <https://skmtc.dev/fleetio/apis/fleetio-developer-api/docs/parts/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of Parts belonging to your account.

## Query parameters

- `start_cursor` string
- `per_page` integer
- `filter` object
  - `manufacturer_part_number` union
    - object
      - `like` string, required
    - object
      - `eq` string, required
  - `number` union
    - object
      - `like` string, required
    - object
      - `eq` string, required
  - `upc` EqFilter
    - `eq` string, required
  - `part_category_id` EqFilter
    - `eq` string, required
  - `part_manufacturer_id` EqFilter
    - `eq` string, required
  - `created_at` union
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
  - `updated_at` union
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
- `sort` object
  - `id` 'asc' | 'desc'
  - `created_at` 'asc' | 'desc'
  - `updated_at` 'asc' | 'desc'

## Response `200`

OK

- object
  - `start_cursor` string, nullable: The current start cursor of the records returned.
  - `next_cursor` string, nullable: The next cursor to retrieve the next page of records.
  - `per_page` integer: The maximum number of records returned.
  - `estimated_remaining_count` integer: The number of remaining records including the returned records, up to a maximum of 500.
  - `filtered_by` union[]: The filters applied to the returned record set.
    - union
      - object
        - `manufacturer_part_number` union
          - object
            - `like` string, required
          - object
            - `eq` string, required
      - object
        - `number` union
          - object
            - `like` string, required
          - object
            - `eq` string, required
      - object
        - `upc` EqFilter
          - `eq` string, required
      - object
        - `part_category_id` EqFilter
          - `eq` string, required
      - object
        - `part_manufacturer_id` EqFilter
          - `eq` string, required
      - object
        - `created_at` union
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
      - object
        - `updated_at` union
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
  - `sorted_by` union[]: The sorts applied to the returned record set.
    - union
      - object
        - `updated_at` 'asc' | 'desc'
      - object
        - `created_at` 'asc' | 'desc'
      - object
        - `id` 'asc' | 'desc'
  - `records` PartSummary[]
    - `created_at` string, date-time, required: The date and time at which this record was created.
    - `images_count` integer, required: The number of images associated with this Part.
    - `documents_count` integer, required: The number of documents associated with this Part.
    - `comments_count` integer, required: The number of comments associated with this Part.
    - `id` integer, required
    - `description` string, nullable, required: A description of this Part.
    - `manufacturer_part_number` string, nullable, required: The part number from this Part's manufacturer.
    - `measurement_unit_id` integer, nullable, required: The id of the Measurement Unit associated with this Part.
    - `number` string, required: The part number being used for this Part within Fleetio.
    - `part_category_id` integer, nullable, required: The id of the Part Category associated with this Part.
    - `part_manufacturer_id` integer, nullable, required: The id of the Part Manufacturer associated with this Part.
    - `upc` string, nullable, required: The Universal Product Code for this Part.
    - `unit_cost_cents` integer, nullable, required: The unit cost in cents for this Part.
    - `average_unit_cost_cents` string, nullable, required: The average unit cost in cents for this Part. FIFO/LIFO accounts only.
    - `default_image_url` string, nullable, required
    - `archived_at` string, date-time, nullable, required: The date and time at which this Part was archived.
    - `attachment_permissions` AttachmentPermissions, nullable, required
      - `read_photos` boolean: Indicates whether the user has read permission for photos.
      - `manage_photos` boolean: Indicates whether the user has permission to manage (eg. upload, delete) photos.
      - `read_documents` boolean: Indicates whether the user has read permission for documents.
      - `manage_documents` boolean: Indicates whether the user has permission to manage (eg. upload, delete) documents.
    - `custom_fields` CustomFields, nullable: *Full details on working with Custom Fields [here](/docs/overview/custom-fields).
    - `part_manufacturer` object, nullable
      - `id` integer
      - `name` string: The name of the Part Manufacturer.
      - `description` string
      - `created_at` string, date-time, nullable: The date and time at which this Part Manufacturer was created.
      - `updated_at` string, date-time, nullable: The date and time at which this Part Manufacturer was last updated.
    - `part_category` PartCategory, nullable
      - `id` integer
      - `tire_category` boolean: Indicates whether part is a tire or not
    - `cross_reference_group_id` integer, nullable: The cross-reference group this Part belongs to, or `null` when it belongs to none. Two Parts sharing a value are compatible with each other, so a list can be read for which Parts have compatible Parts without a request per Part. Only present when the cross-references feature is enabled for the account.

## Other responses

- `400`: The format or parameters of the request was invalid
- `401`: Request could not be authenticated
- `500`: Something unexpected happened

## Changes

- **2026-11-06** `49558d744bd7`: 6 info
  - for the `query` request parameter `per_page`, the min was decreased from `2.00` to `1.00`
  - added the optional property `records/items/cross_reference_group_id` to the response with the `200` status
  - added the required property `records/items/comments_count` to the response with the `200` status
  - added the required property `records/items/created_at` to the response with the `200` status
  - …2 more

[Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/parts/get.md)

---

[API](https://skmtc.dev/fleetio/apis/fleetio-developer-api.md) - [All operations](https://skmtc.dev/fleetio/apis/fleetio-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fleetio/apis/fleetio-developer-api/revisions/49558d744bd7?raw)