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" } ] }
API v2 is entering maintenance mode. New users should start with API v3 to access our latest features and improved performance. Already using v2? Don’t worry, your current integration remains fully functional. Read more about maintenance mode, or check out the migration guide for API v3.
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[]