---
title: "List part transfer requests"
method: GET
path: "/parttransferrequests"
tags: ["Part Transfer Requests"]
---

# List part transfer requests

`GET /parttransferrequests`

Endpoint used to list part transfer request resources

## Query parameters

- `cursor` string — Last pagination reference
- `limit` integer — max number of Part Transfer Requests returned
- `statuses` string[] — To filter by multiple status: `status=APPROVED&status=DECLINED`

## Headers

- `x-organization-id` integer

## Response `200`

Successfully fetched Part Transfer Requests list

- object
  - `partTransferRequests` object[], required
    - `id` integer, required — Global ID of the part transfer request.
    - `quantityReceived` integer, nullable — Quantity of parts received.
    - `quantityRequested` integer, required — Quantity of parts requested for transfer.
    - `quantityTransferred` integer, nullable — Quantity of parts transferred.
    - `requestMessage` string, nullable — Message to give context surrounding the part transfer request.
    - `responseMessage` string, nullable — Message to give context surrounding the transfer of the part transfer request.
    - `status` 'APPROVED' | 'CANCELED' | 'COMPLETED' | 'DECLINED' | 'PENDING' — Status of the part transfer request.
    - `sourcePartId` integer, required — ID of the part that belongs to the organization receiving the request. (Sending stocks)
    - `destinationPartId` integer, required — ID of the part that belongs to the organization performing the request. (Receiving stocks)
    - `transferrerId` integer, nullable — ID of the user performing the transfer. (Sending stocks)
    - `requesterId` integer — ID of the user performing the request. (Requesting/receiving stocks)
    - `destinationOrganizationId` integer, required — ID of the organization performing the request. (Requesting/receiving stocks)
    - `sourceOrganizationId` integer, required — ID of the organization receiving the request. (Sending stocks)
    - `sourceLocationId` integer — ID of the location in the organization from which parts were transferred. (Sending stocks)
    - `destinationLocations` object[] — Locations into which the transferred parts were received. (Receiving stocks)
      - `locationId` integer — ID of the location in the organization where the part is being received. (Receiving stocks)
      - `quantity` integer, required — Quantity of parts received.
  - `nextCursor` string, nullable, required — The cursor to retrieve the next page of Part Transfer Requests.
  - `nextPageUrl` string, nullable, required — Path with query parameters that can be used to retrieve the next page of Part Transfer Requests.

## Other responses

- `400` — Error with query
- `401` — Invalid token

---

[API](https://skmtc.net/getmaintainx/apis/maintainx-api.md) · [All operations](https://skmtc.net/getmaintainx/apis/maintainx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getmaintainx/maintainx-api/revisions/ef9153fcac7c/schema)