Skip to main content
GET
/
pickups
Retrieve a list of pickups
curl --request GET \
  --url https://panel.sendcloud.sc/api/v2/pickups \
  --header 'Authorization: Basic <encoded-value>'
{
  "next": null,
  "previous": null,
  "pickups": [
    {
      "id": 1,
      "pickup_from": "2022-04-06T12:00:00Z",
      "pickup_until": "2022-04-06T17:00:00Z",
      "country": "NL",
      "carrier": "dhl_express",
      "tracking_number": "PRG220406003404",
      "pickup_status": "Cancelled",
      "created_at": "2022-03-30T10:57:02.344479Z",
      "cancelled_at": "2022-03-30T10:57:11.656260Z"
    },
    {
      "id": 2,
      "pickup_from": "2022-04-06T12:00:00Z",
      "pickup_until": "2022-04-06T17:00:00Z",
      "country": "NL",
      "carrier": "dhl_express",
      "tracking_number": "PRG220406002044",
      "pickup_status": "Cancelled",
      "created_at": "2022-03-30T09:20:37.957495Z",
      "cancelled_at": "2022-03-30T09:20:45.433367Z"
    }
  ]
}
This is limited to the carriers which support pickups via the API. The response includes information about when the pickup was scheduled, the latest status, the parcel tracking number and the time frame in which the pickup is due to take place.

Authorizations

​
Authorization
string
header
required

Basic Authentication using API key and secrets is currently the main authentication mechanism.

Query Parameters

​
limit
integer

Amount of pickups that will be shown per page.

Required range: x >= 1

Response

200 - application/json

OK

​
next
string | null

Url to retrieve the next page of pickups.

​
previous
string | null

Url to retrieve the previous page of pickups.

​
pickups
Pickup Object (List Item) · object[]