Get delivery options

curl --request POST \
  --url https://api.smartsend.io/v2/teams/{teamUuid}/delivery-options \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content_type": "commercial_goods",
  "parties": {
    "merchant": {
      "reference": "SHOP-DK",
      "identifier": "shop-1",
      "uri": "https://shop.example.com",
      "address": {
        "address_lines": [
          "Eksempelgade 1"
        ],
        "postal_code": "2100",
        "city": "Copenhagen",
        "country": "DK",
        "administrative_area": "84"
      },
      "contact": {
        "name_lines": [
          "Example Shop"
        ],
        "company": "Example Shop ApS",
        "email": "shop@example.com",
        "phone": "+4587654321"
      },
      "identifiers": {
        "vat": "DK12345678",
        "eori": "DK12345678",
        "gb_eori": "GB123456789000",
        "tax_id": "12345678",
        "voec": "2000123"
      }
    },
    "customer": {
      "reference": "CUSTOMER-2048",
      "identifier": "customer-2048",
      "uri": "https://shop.example.com/admin/customers/2048",
      "address": {
        "address_lines": [
          "Eksempelvej 10"
        ],
        "postal_code": "8000",
        "city": "Aarhus C",
        "country": "DK",
        "administrative_area": "82"
      },
      "contact": {
        "name_lines": [
          "Example Customer"
        ],
        "company": "Example Design ApS",
        "email": "customer@example.com",
        "phone": "+4512345678"
      },
      "identifiers": {
        "vat": "DK87654321",
        "eori": "DK87654321",
        "gb_eori": "GB987654321000",
        "tax_id": "87654321",
        "voec": "2000456"
      }
    }
  },
  "parcels": [
    {
      "reference": "ORDER-1042-1",
      "identifier": "shop-parcel-1",
      "freetext": "Gift wrapped; keep dry.",
      "gross_weight": {
        "value": 1500,
        "unit": "g"
      },
      "length": {
        "value": 30,
        "unit": "cm"
      },
      "width": {
        "value": 20,
        "unit": "cm"
      },
      "height": {
        "value": 15,
        "unit": "cm"
      },
      "total_net_amount": {
        "value": 20000,
        "currency": "DKK"
      },
      "tax_amount": {
        "value": 5000,
        "currency": "DKK"
      },
      "duty_amount": {
        "value": 0,
        "currency": "DKK"
      },
      "items": [
        {
          "reference": "TSHIRT-BLUE-M",
          "identifier": "order-line-9001",
          "uri": "https://shop.example.com/products/blue-t-shirt",
          "image_url": "https://shop.example.com/images/blue-t-shirt.jpg",
          "sku": "TSHIRT-BLUE-M",
          "location": "A1-04",
          "name": "Blue cotton T-shirt, size M",
          "description": "Two blue cotton T-shirts",
          "tariff_code": "610910",
          "country_of_origin": "DK",
          "quantity": 2,
          "total_net_amount": {
            "value": 20000,
            "currency": "DKK"
          },
          "tax_amount": {
            "value": 5000,
            "currency": "DKK"
          },
          "duty_amount": {
            "value": 0,
            "currency": "DKK"
          },
          "net_weight": {
            "value": 1000,
            "unit": "g"
          },
          "cost_amount": {
            "value": 10000,
            "currency": "DKK"
          }
        }
      ]
    }
  ],
  "total_net_amount": {
    "value": 20000,
    "currency": "DKK"
  },
  "tax_amount": {
    "value": 5000,
    "currency": "DKK"
  },
  "duty_amount": {
    "value": 0,
    "currency": "DKK"
  },
  "shipping_net_amount": {
    "value": 3920,
    "currency": "DKK"
  },
  "shipping_tax_amount": {
    "value": 980,
    "currency": "DKK"
  }
}
'

{
  "data": [
    {
      "delivery": {
        "carrier": {
          "code": "postnord",
          "name": "PostNord",
          "logo_url": "https://assets.example.com/carriers/postnord/logo.svg",
          "icon_url": "https://assets.example.com/carriers/postnord/icon.svg"
        },
        "last_mile_carrier": {
          "code": "postnord",
          "name": "PostNord",
          "logo_url": "https://assets.example.com/carriers/postnord/logo.svg",
          "icon_url": "https://assets.example.com/carriers/postnord/icon.svg"
        },
        "service_code": "postnord_agent",
        "service_name": "Service point",
        "is_pickup": true,
        "is_return": false,
        "addons": [
          {
            "code": "SIGNATURE",
            "name": "Signature"
          }
        ]
      },
      "cost_price": {
        "value": 3920,
        "currency": "DKK"
      },
      "delivery_window": {
        "earliest": "2026-09-17T08:00:00Z",
        "latest": "2026-09-17T16:00:00Z"
      },
      "cutoff": "2026-09-16T14:00:00Z",
      "addons": [
        {
          "code": "SIGNATURE",
          "name": "Signature",
          "cost_price": {
            "value": 500,
            "currency": "DKK"
          }
        }
      ]
    }
  ]
}

POST

teams

{teamUuid}

delivery-options

curl --request POST \
  --url https://api.smartsend.io/v2/teams/{teamUuid}/delivery-options \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content_type": "commercial_goods",
  "parties": {
    "merchant": {
      "reference": "SHOP-DK",
      "identifier": "shop-1",
      "uri": "https://shop.example.com",
      "address": {
        "address_lines": [
          "Eksempelgade 1"
        ],
        "postal_code": "2100",
        "city": "Copenhagen",
        "country": "DK",
        "administrative_area": "84"
      },
      "contact": {
        "name_lines": [
          "Example Shop"
        ],
        "company": "Example Shop ApS",
        "email": "shop@example.com",
        "phone": "+4587654321"
      },
      "identifiers": {
        "vat": "DK12345678",
        "eori": "DK12345678",
        "gb_eori": "GB123456789000",
        "tax_id": "12345678",
        "voec": "2000123"
      }
    },
    "customer": {
      "reference": "CUSTOMER-2048",
      "identifier": "customer-2048",
      "uri": "https://shop.example.com/admin/customers/2048",
      "address": {
        "address_lines": [
          "Eksempelvej 10"
        ],
        "postal_code": "8000",
        "city": "Aarhus C",
        "country": "DK",
        "administrative_area": "82"
      },
      "contact": {
        "name_lines": [
          "Example Customer"
        ],
        "company": "Example Design ApS",
        "email": "customer@example.com",
        "phone": "+4512345678"
      },
      "identifiers": {
        "vat": "DK87654321",
        "eori": "DK87654321",
        "gb_eori": "GB987654321000",
        "tax_id": "87654321",
        "voec": "2000456"
      }
    }
  },
  "parcels": [
    {
      "reference": "ORDER-1042-1",
      "identifier": "shop-parcel-1",
      "freetext": "Gift wrapped; keep dry.",
      "gross_weight": {
        "value": 1500,
        "unit": "g"
      },
      "length": {
        "value": 30,
        "unit": "cm"
      },
      "width": {
        "value": 20,
        "unit": "cm"
      },
      "height": {
        "value": 15,
        "unit": "cm"
      },
      "total_net_amount": {
        "value": 20000,
        "currency": "DKK"
      },
      "tax_amount": {
        "value": 5000,
        "currency": "DKK"
      },
      "duty_amount": {
        "value": 0,
        "currency": "DKK"
      },
      "items": [
        {
          "reference": "TSHIRT-BLUE-M",
          "identifier": "order-line-9001",
          "uri": "https://shop.example.com/products/blue-t-shirt",
          "image_url": "https://shop.example.com/images/blue-t-shirt.jpg",
          "sku": "TSHIRT-BLUE-M",
          "location": "A1-04",
          "name": "Blue cotton T-shirt, size M",
          "description": "Two blue cotton T-shirts",
          "tariff_code": "610910",
          "country_of_origin": "DK",
          "quantity": 2,
          "total_net_amount": {
            "value": 20000,
            "currency": "DKK"
          },
          "tax_amount": {
            "value": 5000,
            "currency": "DKK"
          },
          "duty_amount": {
            "value": 0,
            "currency": "DKK"
          },
          "net_weight": {
            "value": 1000,
            "unit": "g"
          },
          "cost_amount": {
            "value": 10000,
            "currency": "DKK"
          }
        }
      ]
    }
  ],
  "total_net_amount": {
    "value": 20000,
    "currency": "DKK"
  },
  "tax_amount": {
    "value": 5000,
    "currency": "DKK"
  },
  "duty_amount": {
    "value": 0,
    "currency": "DKK"
  },
  "shipping_net_amount": {
    "value": 3920,
    "currency": "DKK"
  },
  "shipping_tax_amount": {
    "value": 980,
    "currency": "DKK"
  }
}
'

{
  "data": [
    {
      "delivery": {
        "carrier": {
          "code": "postnord",
          "name": "PostNord",
          "logo_url": "https://assets.example.com/carriers/postnord/logo.svg",
          "icon_url": "https://assets.example.com/carriers/postnord/icon.svg"
        },
        "last_mile_carrier": {
          "code": "postnord",
          "name": "PostNord",
          "logo_url": "https://assets.example.com/carriers/postnord/logo.svg",
          "icon_url": "https://assets.example.com/carriers/postnord/icon.svg"
        },
        "service_code": "postnord_agent",
        "service_name": "Service point",
        "is_pickup": true,
        "is_return": false,
        "addons": [
          {
            "code": "SIGNATURE",
            "name": "Signature"
          }
        ]
      },
      "cost_price": {
        "value": 3920,
        "currency": "DKK"
      },
      "delivery_window": {
        "earliest": "2026-09-17T08:00:00Z",
        "latest": "2026-09-17T16:00:00Z"
      },
      "cutoff": "2026-09-16T14:00:00Z",
      "addons": [
        {
          "code": "SIGNATURE",
          "name": "Signature",
          "cost_price": {
            "value": 500,
            "currency": "DKK"
          }
        }
      ]
    }
  ]
}

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

Optional client-supplied request identifier. When provided and matching the validation pattern, the value is echoed back in the Request-ID response header. Otherwise the server generates one. Use this to correlate requests between client and server when reporting issues.

Required string length: 1 - 64

Pattern: ^[A-Za-z0-9._-]{1,64}$

Path Parameters

teamUuid

string<uuid>

required

Team uuid. All resources are scoped to this team.

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). When omitted, return services are excluded by default.

Body

application/json

Use the same party, parcel and measurement structures as booking. Every supplied amount includes value and currency; every supplied weight or dimension includes value and unit. Within one shipment, all non-null amounts use the same currency, all weights use the same unit, and all parcel dimensions use the same unit. Missing or invalid object fields and mixed currencies or units return 422; currency and units never fall back to team defaults. Missing weights or dimensions remain unspecified during discovery. Does not create a shipment or reserve carrier capacity.

parties

object

required

Omit merchant to use the appropriate team address. Pickup points belong to delivery.

Show child attributes

parcels

object[]

required

Parcels in stable input order.

Minimum array length: 1

Show child attributes

content_type

enum<string>

Type of contents in the shipment

Available options:

commercial_goods,

returned_goods,

gift,

commercial_sample,

documents,

other

total_net_amount

null | object

Total goods value excluding tax.

Show child attributes

Example:

{ "value": 15920, "currency": "DKK" }

tax_amount

null | object

Total goods tax.

Show child attributes

Example:

{ "value": 3980, "currency": "DKK" }

duty_amount

null | object

Total goods duty.

Show child attributes

Example:

{ "value": 5572, "currency": "DKK" }

shipping_net_amount

null | object

Shipping cost excluding tax.

Show child attributes

Example:

{ "value": 3920, "currency": "DKK" }

shipping_tax_amount

null | object

Shipping tax.

Show child attributes

Example:

{ "value": 980, "currency": "DKK" }

Response

Delivery options retrieved successfully

data

object[]

required

Show child attributes

API Reference

API v1

API v2

Get delivery options

Authorizations

Headers

Path Parameters

Query Parameters

Body

Response