Retrieve shipping option transit times

curl --request GET \
  --url https://panel.sendcloud.sc/api/v3/analytics/transit-times/shipping-options \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://panel.sendcloud.sc/api/v3/analytics/transit-times/shipping-options"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://panel.sendcloud.sc/api/v3/analytics/transit-times/shipping-options', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://panel.sendcloud.sc/api/v3/analytics/transit-times/shipping-options",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://panel.sendcloud.sc/api/v3/analytics/transit-times/shipping-options"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://panel.sendcloud.sc/api/v3/analytics/transit-times/shipping-options")
  .header("Authorization", "Basic <encoded-value>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://panel.sendcloud.sc/api/v3/analytics/transit-times/shipping-options")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

{
  "transit_times": [
    {
      "shipping_option_code": "postnl_standard",
      "from_country_code": "NL",
      "to_country_code": "AT",
      "start_date": "2025-03-01T00:00:00Z",
      "end_date": "2025-03-31T23:59:59Z",
      "total_parcels": 842,
      "transit_time_hours": 50.1,
      "transit_time_days": 2
    },
    {
      "shipping_option_code": "dhl_express",
      "from_country_code": "NL",
      "to_country_code": "DE",
      "start_date": "2025-03-01T00:00:00Z",
      "end_date": "2025-03-31T23:59:59Z",
      "total_parcels": 217,
      "transit_time_hours": 26.4,
      "transit_time_days": 1
    }
  ]
}

GET

analytics

transit-times

shipping-options

Retrieve shipping option transit times

curl --request GET \
  --url https://panel.sendcloud.sc/api/v3/analytics/transit-times/shipping-options \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://panel.sendcloud.sc/api/v3/analytics/transit-times/shipping-options"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://panel.sendcloud.sc/api/v3/analytics/transit-times/shipping-options', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://panel.sendcloud.sc/api/v3/analytics/transit-times/shipping-options",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://panel.sendcloud.sc/api/v3/analytics/transit-times/shipping-options"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://panel.sendcloud.sc/api/v3/analytics/transit-times/shipping-options")
  .header("Authorization", "Basic <encoded-value>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://panel.sendcloud.sc/api/v3/analytics/transit-times/shipping-options")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

{
  "transit_times": [
    {
      "shipping_option_code": "postnl_standard",
      "from_country_code": "NL",
      "to_country_code": "AT",
      "start_date": "2025-03-01T00:00:00Z",
      "end_date": "2025-03-31T23:59:59Z",
      "total_parcels": 842,
      "transit_time_hours": 50.1,
      "transit_time_days": 2
    },
    {
      "shipping_option_code": "dhl_express",
      "from_country_code": "NL",
      "to_country_code": "DE",
      "start_date": "2025-03-01T00:00:00Z",
      "end_date": "2025-03-31T23:59:59Z",
      "total_parcels": 217,
      "transit_time_hours": 26.4,
      "transit_time_days": 1
    }
  ]
}

Transit times are aggregated from your account’s recent shipping activity. The response contains one record per (shipping_option_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

shipping_option_code

string[]

required

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

Minimum array length: 1

Required string length: 1 - 256

Example:

["postnl_standard", "dhl_express"]

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

Response schema for the shipping option transit times endpoint.

transit_times

ShippingOptionTransitTimeRecord · object[]

required

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

Show child attributes

Retrieve carrier transit times Reporting API overview

⌘I

General

Authentication & account

Shipping

Checkout & delivery options

Tracking & post-purchase

Events & notifications

Carriers & pickups

Financial

Data & insights

Integrations

Retrieve shipping option transit times

Authorizations

Query Parameters

Response