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 } ] }
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.