Skip to main content
GET
/
analytics
/
transit-times
/
carriers
Retrieve carrier transit times
curl --request GET \
  --url https://panel.sendcloud.sc/api/v3/analytics/transit-times/carriers \
  --header 'Authorization: Basic <encoded-value>'
{
  "transit_times": [
    {
      "carrier_code": "postnl",
      "from_country_code": "NL",
      "to_country_code": "AT",
      "start_date": "2025-03-01T00:00:00Z",
      "end_date": "2025-03-31T23:59:59Z",
      "total_parcels": 1284,
      "transit_time_hours": 48.5,
      "transit_time_days": 2
    },
    {
      "carrier_code": "postnl",
      "from_country_code": "NL",
      "to_country_code": "DE",
      "start_date": "2025-03-01T00:00:00Z",
      "end_date": "2025-03-31T23:59:59Z",
      "total_parcels": 932,
      "transit_time_hours": 36.2,
      "transit_time_days": 2
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://sendcloud.dev/llms.txt

Use this file to discover all available pages before exploring further.

Transit times are aggregated from your account’s recent shipping activity. The response contains one record per (carrier_code, from_country_code, to_country_code) row; rows with no transit-time data are omitted. When start_date and end_date are omitted, the response covers the last 90 days (UTC). start_date must be on or before end_date.

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
carrier_code
string[]
required

One or more carrier codes to retrieve transit times for. Repeat the parameter to pass multiple values.

Minimum array length: 1
Minimum string length: 1
Example:
["postnl", "dhl"]
​
from_country_code
string[]

ISO 3166-1 alpha-2 country codes of the origin to filter by. Repeat the parameter to pass multiple values.

Required string length: 2
Example:
["NL"]
​
to_country_code
string[]

ISO 3166-1 alpha-2 country codes of the destination to filter by. Repeat the parameter to pass multiple values.

Required string length: 2
Example:
["AT", "DE"]
​
start_date
string<date>

Inclusive start of the window in YYYY-MM-DD format. Defaults to 90 days before today (UTC) when omitted.

Example:

"2025-03-01"

​
end_date
string<date>

Inclusive end of the window in YYYY-MM-DD format. Defaults to today (UTC) when omitted.

Example:

"2025-03-31"

Response

OK

Response schema for the carrier transit times endpoint.

​
transit_times
CarrierTransitTimeRecord · object[]
required

Aggregated transit-time records matching the requested filters. Rows with no transit-time data are omitted.