Retrieve a list of shipping methods
curl --request GET \
--url https://panel.sendcloud.sc/api/v2/shipping_methods \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://panel.sendcloud.sc/api/v2/shipping_methods"
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/v2/shipping_methods', 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/v2/shipping_methods",
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/v2/shipping_methods"
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/v2/shipping_methods")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://panel.sendcloud.sc/api/v2/shipping_methods")
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{
"next": null,
"previous": null,
"shipping_methods": [
{
"id": 8020,
"name": "DHLForYou Drop Off - Agecheck 18+",
"carrier": "dhl",
"min_weight": "0.001",
"max_weight": "23.001",
"service_point_input": "none",
"price": 0,
"countries": [
{
"id": 2,
"name": "Netherlands",
"price": 9.75,
"currency": "EUR",
"converted_price": {
"value": "8.39",
"currency": "GBP",
"rate": "0.86100000",
"rate_date": "2026-10-28",
"reference_rate": "0.84411765",
"currency_conversion_fee": {
"rate": "0.0200",
"value": "0.16",
"currency": "GBP"
}
},
"iso_2": "NL",
"iso_3": "NLD",
"lead_time_hours": 24,
"price_breakdown": [
{
"type": "price_without_insurance",
"label": "Label",
"value": 8.55
},
{
"type": "fuel",
"label": "Fuel surcharge (14.00%)",
"value": 1.2
}
]
}
]
},
{
"id": 8021,
"name": "DHLForYou - Agecheck 18+",
"carrier": "dhl",
"min_weight": "0.001",
"max_weight": "23.001",
"service_point_input": "none",
"price": 0,
"countries": [
{
"id": 2,
"name": "Netherlands",
"price": 10.01,
"currency": "EUR",
"converted_price": {
"value": "8.62",
"currency": "GBP",
"rate": "0.86100000",
"rate_date": "2026-10-28",
"reference_rate": "0.84411765",
"currency_conversion_fee": {
"rate": "0.0200",
"value": "0.17",
"currency": "GBP"
}
},
"iso_2": "NL",
"iso_3": "NLD",
"lead_time_hours": 24,
"price_breakdown": [
{
"type": "price_without_insurance",
"label": "Label",
"value": 8.78
},
{
"type": "fuel",
"label": "Fuel surcharge (14.00%)",
"value": 1.23
}
]
}
]
}
]
}Shipping methods API
Retrieve a list of shipping methods
Returns a detailed list of all the shipping methods which are available to you under your Sendcloud credentials.
GET
/
shipping_methods
Retrieve a list of shipping methods
curl --request GET \
--url https://panel.sendcloud.sc/api/v2/shipping_methods \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://panel.sendcloud.sc/api/v2/shipping_methods"
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/v2/shipping_methods', 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/v2/shipping_methods",
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/v2/shipping_methods"
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/v2/shipping_methods")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://panel.sendcloud.sc/api/v2/shipping_methods")
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{
"next": null,
"previous": null,
"shipping_methods": [
{
"id": 8020,
"name": "DHLForYou Drop Off - Agecheck 18+",
"carrier": "dhl",
"min_weight": "0.001",
"max_weight": "23.001",
"service_point_input": "none",
"price": 0,
"countries": [
{
"id": 2,
"name": "Netherlands",
"price": 9.75,
"currency": "EUR",
"converted_price": {
"value": "8.39",
"currency": "GBP",
"rate": "0.86100000",
"rate_date": "2026-10-28",
"reference_rate": "0.84411765",
"currency_conversion_fee": {
"rate": "0.0200",
"value": "0.16",
"currency": "GBP"
}
},
"iso_2": "NL",
"iso_3": "NLD",
"lead_time_hours": 24,
"price_breakdown": [
{
"type": "price_without_insurance",
"label": "Label",
"value": 8.55
},
{
"type": "fuel",
"label": "Fuel surcharge (14.00%)",
"value": 1.2
}
]
}
]
},
{
"id": 8021,
"name": "DHLForYou - Agecheck 18+",
"carrier": "dhl",
"min_weight": "0.001",
"max_weight": "23.001",
"service_point_input": "none",
"price": 0,
"countries": [
{
"id": 2,
"name": "Netherlands",
"price": 10.01,
"currency": "EUR",
"converted_price": {
"value": "8.62",
"currency": "GBP",
"rate": "0.86100000",
"rate_date": "2026-10-28",
"reference_rate": "0.84411765",
"currency_conversion_fee": {
"rate": "0.0200",
"value": "0.17",
"currency": "GBP"
}
},
"iso_2": "NL",
"iso_3": "NLD",
"lead_time_hours": 24,
"price_breakdown": [
{
"type": "price_without_insurance",
"label": "Label",
"value": 8.78
},
{
"type": "fuel",
"label": "Fuel surcharge (14.00%)",
"value": 1.23
}
]
}
]
}
]
}OAuth2 scopes required:
read:shipping-method. See Scopes for OAuth apps.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.
id, which you can then use in your request to the Create a parcel or parcels endpoint.
When creating a parcel via the Create a parcel or parcels endpoint, if a shipping method id value is present, and if the request_label parameter has the value true, then a shipping label is created and the parcel is announced.
The shipping methods returned from this endpoint are based on the following factors:
- The carriers you have enabled in your Sendcloud account;
- (Optional) The direct carrier contracts you have connected;
- Your sender address
Tip: Via this endpoint you can only retrieve shipping methods based on three parameters:
sender_address, service_point_id and is_return. If you need to filter the results because you require a method which contains a specific shipping functionality or other criteria, you can refer to the Retrieve a list of shipping products endpoint.In order to view remote surcharges, you are required to provide the
to_country and to_postal_code. Similarly, to access zonal prices, you need to provide to_country, from_postal_code and to_postal_code. This information ensures accurate and customized pricing based on the specific location, enabling you to understand any additional charges associated with remote areas and access pricing based on their designated zones.Specifying a sender address
You can have multiple sender addresses stored in your Sendcloud account. This endpoint will return the shipping methods associated with your default sender address, unless you provide a specificsender_address id.
Tip: You can find the
id for each of your sender addresses via the Retrieve a sender address endpoint.sender_address id, this endpoint will only return shipping methods applicable for shipments from the Netherlands.
To see shipping methods applicable for Austria, e.g. from DPD Austria, specify the id for your Austrian sender address in the HTTP request. The retrieved results will now include carriers such as Post AT, DPD Austria, etc, depending on your enabled carriers.
Example request method and URL
GET https://panel.sendcloud.sc/api/v2/shipping_methods?sender_address={ID}
Find a service point delivery shipping method
If you want to retrieve a list of shipping methods which are applicable for service point delivery, provide aservice_point_id as a query parameter. You can find an appropriate service_point_id via the Service points API.
Find a suitable shipping method for a return
Return shipping methods are treated differently than methods for outgoing parcels. If you want to filter the results to show only the methods which you can apply to return parcels, include the query parameteris_return=true.
Invalid shipment ID error message
If you try to Create a parcel but receive the error message “Invalid shipment id”, this could be because the specifiedid relates to a shipping method which is not possible for the given destination address.
For example, if you need to ship a parcel internationally but the specific shipping method only supports national (domestic) shipping, then you would need to lookup a new shipping method id which supports method of delivery and change the request.Authorizations
HTTPBasicAuthOAuth2ClientCreds
Query Parameters
A country ISO 2 code for the recipient country. Required if the carrier is zonal. Also required to see if remote surcharges apply. A country represented by its ISO 3166-1 alpha-2 code
Available options:
AW, AF, AO, AI, AX, AL, AD, AE, AR, AM, AS, AQ, TF, AG, AU, AT, AZ, BI, BE, BJ, BQ, BF, BD, BG, BH, BS, BA, BL, BY, BZ, BM, BO, BR, BB, BN, BT, BV, BW, CF, CA, CC, CH, CL, CN, CI, CM, CD, CG, CK, CO, KM, CV, CR, CU, CW, CX, KY, CY, CZ, DE, DJ, DM, DK, DO, DZ, EC, EG, ER, EH, ES, EE, ET, FI, FJ, FK, FR, FO, FM, GA, GB, GE, GG, GH, GI, GN, GP, GM, GW, GQ, GR, GD, GL, GT, GF, GU, GY, HK, HM, HN, HR, HT, HU, ID, IM, IN, IO, IE, IR, IQ, IS, IL, IT, JM, JE, JO, JP, KZ, KE, KG, KH, KI, KN, KR, KW, LA, LB, LR, LY, LC, LI, LK, LS, LT, LU, LV, MO, MF, MA, MC, MD, MG, MV, MX, MH, MK, ML, MT, MM, ME, MN, MP, MZ, MR, MS, MQ, MU, MW, MY, YT, NA, NC, NE, NF, NG, NI, NU, NL, NO, NP, NR, NZ, OM, PK, PA, PN, PE, PH, PW, PG, PL, PR, KP, PT, PY, PS, PF, QA, RE, RO, RU, RW, SA, SD, SN, SG, GS, SH, SJ, SB, SL, SV, SM, SO, PM, RS, SS, ST, SR, SK, SI, SE, SZ, SX, SC, SY, TC, TD, TG, TH, TJ, TK, TM, TL, TO, TT, TN, TR, TV, TW, TZ, UG, UA, UM, UY, US, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, YE, ZA, ZM, ZW, IC, XK Example:
"NL"