Retrieve a list of shipping methods

GET {{baseUrl}}/shipping_methods?sender_address=<string>&service_point_id=<integer>&is_return=<boolean>&from_postal_code=<string>&to_postal_code=<string>&to_country=IO

This endpoint will return a detailed list of all the shipping methods which are available to you under your Sendcloud credentials. You can use this endpoint to find a specific shipping method id, which you can then specify in your request to Create a parcel.

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 are based on the following factors: 1. The carriers you have enabled in your Sendcloud account; 2. (Optional) The direct carrier contracts you have connected; and, 3. 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 specific sender_adress id.

Tip: You can find the id for each of your sender addresses via the Retrieve a single sender address endpoint.

Use case

For example, your default sender address may be based in the Netherlands, but you have a second sender address based in Austria. If you don't specify a 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:

GET https://panel.sendcloud.sc/api/v2/shipping_methods?sender_address={ID}


Use cases

  • 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 a service_point_id in the request. 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 argument is_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 specified id 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.

Request Params

KeyDatatypeRequiredDescription
sender_addressstringThe ID of the sender address for which you would like to know the available shipping methods. If you want to retrieve all available shipping methods, please use all as a value for this parameter. Required if the carrier is zonal.
service_point_idstringThe ID of the service point for which you would like to know the available shipping methods.
is_returnstringIf set to true the endpoint will return shipping methods which can be used for making a return shipment.
from_postal_codestringPostal code of the sender. Required if the carrier is zonal.
to_postal_codestringPostal code of the recipient. Required if the carrier is zonal. Also required to see if remote surcharges apply.
to_countrystringA country ISO 2 code for the recipient country. Required if the carrier is zonal. Also required to see if remote surcharges apply.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;shipping_methods&quot;:[{&quot;id&quot;:&quot;\u003clong\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;carrier&quot;:&quot;\u003cstring\u003e&quot;,&quot;min_weight&quot;:&quot;\u003cstring\u003e&quot;,&quot;max_weight&quot;:&quot;\u003cstring\u003e&quot;,&quot;service_point_input&quot;:&quot;none&quot;,&quot;price&quot;:&quot;\u003clong\u003e&quot;,&quot;countries&quot;:[{&quot;id&quot;:&quot;\u003clong\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;price&quot;:&quot;\u003cnumber\u003e&quot;,&quot;iso_2&quot;:&quot;\u003cstring\u003e&quot;,&quot;iso_3&quot;:&quot;\u003cstring\u003e&quot;,&quot;lead_time_hours&quot;:&quot;\u003cinteger\u003e&quot;,&quot;price_breakdown&quot;:[{&quot;type&quot;:&quot;\u003cstring\u003e&quot;,&quot;label&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cfloat\u003e&quot;},{&quot;type&quot;:&quot;\u003cstring\u003e&quot;,&quot;label&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cfloat\u003e&quot;}]},{&quot;id&quot;:&quot;\u003clong\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;price&quot;:&quot;\u003cnumber\u003e&quot;,&quot;iso_2&quot;:&quot;\u003cstring\u003e&quot;,&quot;iso_3&quot;:&quot;\u003cstring\u003e&quot;,&quot;lead_time_hours&quot;:&quot;\u003cinteger\u003e&quot;,&quot;price_breakdown&quot;:[{&quot;type&quot;:&quot;\u003cstring\u003e&quot;,&quot;label&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cfloat\u003e&quot;},{&quot;type&quot;:&quot;\u003cstring\u003e&quot;,&quot;label&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cfloat\u003e&quot;}]}]}]}