Skip to main content
POST
/
team
/
{team}
/
rates
Get shipping rates
curl --request POST \
  --url https://app.smartsend.io/api/v2/team/{team}/rates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "currency": "<string>",
  "parties": {
    "receiver": {
      "address": {
        "address_lines": "<unknown>",
        "postal_code": "<unknown>",
        "city": "<string>",
        "country": "<string>",
        "administrative_area": "<unknown>"
      }
    }
  },
  "parcels": [
    {
      "gross_weight": "<unknown>",
      "length": "<unknown>",
      "width": "<unknown>",
      "height": "<unknown>",
      "items": "<unknown>"
    }
  ]
}
'
{
  "data": [
    {
      "available": true,
      "delivery": {
        "carrier_code": "<unknown>",
        "carrier_name": "<unknown>",
        "carrier_logo_url": "<unknown>",
        "carrier_icon_url": "<unknown>",
        "service_code": "<unknown>",
        "service_name": "<unknown>",
        "is_pickup": "<unknown>",
        "is_return": "<unknown>",
        "addons": "<unknown>"
      },
      "cost_price": "<unknown>",
      "delivery_window": "<unknown>",
      "cutoff": "<unknown>",
      "addons": "<unknown>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Accept-Language
string
default:en

Preferred language(s) for translatable content using BCP 47 language tags. Supports quality values (q-factors) for priority ordering. The API negotiates the best available language based on this header, the team's configured language, and available translations. If omitted, the team's default language is used.

Example:

"da-DK, da;q=0.9, en;q=0.8"

​
Request-ID
string

Any value passed in this request will be returned in the same header. This can be used to correlate requests between client and server.

Required string length: 1 - 128
​
Idempotency-Key
string

Optional idempotency key for safely retrying requests. If the same key is reused with the same request payload within 30 minutes, the API will return the exact same response (status code, headers, and body) as the original request without re-executing it. Reuse of the same key with a different payload may return 409 Conflict.

Required string length: 1 - 128

Path Parameters

​
team
string
required

Team identifier. All resources are scoped to this team.

Minimum string length: 1
Example:

"ad9546c1-393e-49a5-9a72-5cc146c9bec5"

Query Parameters

​
carriers
string[]

Only include rates from these carriers (e.g., postnord, gls)

​
is_return
boolean

Filter by return services (true) or outbound services (false)

Body

application/json
​
currency
string
required

ISO 4217 currency code for all monetary values

Example:

"EUR"

​
parties
object
required

Parties involved in the shipment

​
parcels
object[]
required

List of parcels to be shipped

Minimum array length: 1

Response

Rates retrieved successfully

​
data
object[]
required