---
title: "List Part Location Details"
method: GET
path: "/part_location_details"
tags: ["Part Location Details"]
---

# List Part Location Details

`GET /part_location_details`

## Request

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

Returns a list of Part Location Details belonging to your account.
Each record includes Part Location inventory details and the associated
`Part` and `Part Location`.

## Query parameters

- `start_cursor` string
- `per_page` integer
- `filter` object
  - `part_id` EqFilter
    - `eq` string, required
  - `part_location_id` EqFilter
    - `eq` string, required
  - `part_number_or_description` LikeFilter
    - `like` string, required
  - `active` BooleanFilter
    - `eq` 'true' | 'false', required
  - `track_inventory` BooleanFilter
    - `eq` 'true' | 'false', 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
        - `part_id` EqFilter
          - `eq` string, required
      - object
        - `part_location_id` EqFilter
          - `eq` string, required
      - object
        - `part_number_or_description` LikeFilter
          - `like` string, required
      - object
        - `active` BooleanFilter
          - `eq` 'true' | 'false', required
      - object
        - `track_inventory` BooleanFilter
          - `eq` 'true' | 'false', 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` PartLocationDetailWithPartAndLocation[]
    - `id` integer, required
    - `created_at` string, date-time: The date and time at which this record was created.
    - `updated_at` string, date-time: The date and time at which this record was most recently updated.
    - `account_id` integer, required
    - `active` boolean, required
    - `aisle` string, nullable
    - `available_quantity` number, float, nullable
    - `available_quantity_updated_at` string, date-time, nullable
    - `average_unit_cost_cents` number, float, nullable
    - `bin` string, nullable
    - `last_printed_at` string, date-time, nullable
    - `max_quantity` number, float, nullable
    - `part_archived_at` string, date-time, nullable
    - `part_id` integer, required
    - `part_location_archived_at` string, date-time, nullable
    - `part_location_id` integer, required
    - `quantity_allocated_to_work_orders` number, float, nullable
    - `quantity_on_hand` number, float, nullable
    - `quantity_on_order` number, float, nullable
    - `quantity_requested` number, float, nullable
    - `reorder_point` number, float, nullable
    - `reorder_point_enabled` boolean, required
    - `reorder_point_lead_time_days` integer, nullable
    - `reorder_quantity` number, float, nullable
    - `reorder_quantity_lead_time_days` integer, nullable
    - `row` string, nullable
    - `total_inventory_value_cents` number, float, nullable
    - `track_inventory` boolean, required
    - `watchers_count` integer, required
    - `part` PartMiniWithDefaultImageUrls, required: A Part
      - `id` integer
      - `description` string, nullable: A description of this Part.
      - `manufacturer_part_number` string, nullable: The part number from this Part's manufacturer.
      - `measurement_unit_id` integer, nullable: The id of the `MeasurementUnit` associated with this Part.
      - `number` string: The part number being used for this Part within Fleetio.
      - `part_category_id` integer, nullable: The id of the `PartCategory` associated with this Part.
      - `part_manufacturer_id` integer, nullable: The id of the `PartManufacturer` associated with this Part.
      - `upc` string, nullable: The Universal Product Code for this Part.
      - `average_unit_cost_cents` integer, nullable: The average unit cost in cents for this Part. FIFO/LIFO accounts only.
      - `unit_cost_cents` integer, nullable: The unit cost in cents for this Part.
      - `archived_at` string, date-time, nullable: The date and time at which this Part was archived.
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `default_image_url` string, nullable: A large URL for the default image attached to this Part.
      - `default_image_url_medium` string, nullable: A medium URL for the default image attached to this Part.
      - `default_image_url_small` string, nullable: A small URL for the default image attached to this Part.
      - `default_image_url_large` string, nullable: A full-size URL for the default image attached to this Part.
    - `part_location` PartLocation, required: A Part Location
      - `id` integer
      - `created_at` string, date-time: The date and time at which this record was created.
      - `updated_at` string, date-time: The date and time at which this record was most recently updated.
      - `account_id` integer, required
      - `name` string, required: The name of this Part Location.
      - `description` string, nullable, required: A description of this Part Location.
      - `archived_at` string, date-time, nullable, required: The date and time at which this Part Location was archived.
      - `metadata` object, required: If this Part Location has any metadata, it will be shown here.
        - `has_work_orders` boolean: Whether or not this Part Location has any `Work Orders`.
        - `has_active_work_orders` boolean: Whether or not this Part Location has any active `Work Orders`.
        - `has_purchase_orders` boolean: Whether or not this Part Location has any `Purchase Orders`.
        - `has_active_purchase_orders` boolean: Whether or not this Part Location has any active `Purchase Orders`.
        - `has_inventory_sets` boolean: Whether or not this Part Location has any `Inventory Sets`.
        - `has_active_inventory_sets` boolean: Whether or not this Part Location has any active `Inventory Sets`.

## 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`: 2 info
  - for the `query` request parameter `per_page`, the min was decreased from `2.00` to `1.00`
  - added the optional property `records/items/allOf[subschema #2]/max_quantity` to the response with the `200` status
- **2026-06-16** `4098a1c81821`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/part_location_details/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)