---
title: "Get Pickups List"
method: GET
path: "/pickupslist"
tags: ["PickupApi"]
---

# Get Pickups List

`GET /pickupslist`

Retrieves a scheduled pickup entry by shipment ID or pickup list number, and returns a generated PDF pickup document.

## Query parameters

- `shipmentid` integer
- `pickupslistnumber` integer
- `copies` integer
- `mini` boolean

## Response `200`

OK

- ClientAPIPickupsListResultDto
  - `status` 'OK' | 'Error' | 'ValidationFailed' — 0 = OK, 1 = Error, 2 = ValidationFailed
  - `validations` ClientAPIValidation[], nullable
    - `code` integer
    - `message` string, nullable
    - `params` object, nullable
  - `shipmentids` integer[], nullable — List of shipment IDs associated with this pickup.
  - `pickupdocument` string, nullable — Base64-encoded PDF pickup document for this pickup entry.
  - `pickupinterval` TimeIntervalDate
    - `from` string, nullable — Start of the pickup/delivery interval (ISO 8601 datetime string).
    - `until` string, nullable — End of the pickup/delivery interval (ISO 8601 datetime string).
  - `error` ClientAPIError
    - `code` integer
    - `message` string, nullable
    - `stackTrace` string, nullable
    - `innerException` ClientAPIError — recursive
    - `validations` ClientAPIValidation[], nullable
      - `code` integer
      - `message` string, nullable
      - `params` object, nullable
    - `messageParams` string[], nullable
    - `payload` JToken[]
  - `traceID` string, nullable — Unique trace identifier for debugging and support purposes.

---

[API](https://skmtc.dev/expressone/apis/client-api.md) · [All operations](https://skmtc.dev/expressone/apis/client-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/expressone/client-api/revisions/2acf7e4a5080/schema)