curl --request GET \
--url https://api.smartsend.io/v2/teams/{teamUuid}/shipments \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.smartsend.io/v2/teams/{teamUuid}/shipments"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.smartsend.io/v2/teams/{teamUuid}/shipments', 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://api.smartsend.io/v2/teams/{teamUuid}/shipments",
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: Bearer <token>"
],
]);
$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://api.smartsend.io/v2/teams/{teamUuid}/shipments"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.smartsend.io/v2/teams/{teamUuid}/shipments")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.smartsend.io/v2/teams/{teamUuid}/shipments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"currency": "DKK",
"weight_unit": "g",
"dimension_unit": "cm",
"invoice_number": null,
"reference": "ORDER-1042",
"identifier": "shop-order-1042",
"uri": null,
"delivery": {
"carrier": {
"code": "postnord",
"name": "PostNord",
"logo_url": null,
"icon_url": null
},
"last_mile_carrier": {
"code": "postnord",
"name": "PostNord",
"logo_url": null,
"icon_url": null
},
"service_code": "postnord_agent",
"service_name": "Service point",
"is_pickup": true,
"is_return": false,
"addons": [],
"pickup_point": {
"uuid": "99999999-9999-4999-8999-999999999999",
"carrier_code": "postnord",
"code": "12345",
"name": "Example Parcel Shop",
"address": {
"address_lines": [
"Eksempelvej 20"
],
"postal_code": "8000",
"city": "Aarhus C",
"country": "DK",
"administrative_area": null
}
},
"delivery_window": null,
"incoterm": null
},
"parties": {
"merchant": {
"reference": null,
"identifier": null,
"uri": null,
"address": {
"address_lines": [
"Eksempelgade 1"
],
"postal_code": "2100",
"city": "Copenhagen",
"country": "DK",
"administrative_area": null
},
"contact": {
"name_lines": [
"Example Shop"
],
"company": "Example Shop",
"email": "shop@example.com",
"phone": "+4587654321"
},
"identifiers": null
},
"customer": {
"reference": null,
"identifier": null,
"uri": null,
"address": {
"address_lines": [
"Eksempelvej 10"
],
"postal_code": "8000",
"city": "Aarhus C",
"country": "DK",
"administrative_area": null
},
"contact": {
"name_lines": [
"Example Customer"
],
"company": null,
"email": "customer@example.com",
"phone": "+4512345678"
},
"identifiers": null
}
},
"parcels": [
{
"reference": "ORDER-1042-1",
"identifier": "shop-parcel-1",
"freetext": null,
"gross_weight": 1500,
"length": 30,
"width": 20,
"height": 15,
"total_net_amount": null,
"tax_amount": null,
"duty_amount": null,
"items": [],
"uuid": "33333333-3333-4333-8333-333333333333",
"tracking_number": "00340434161094015749",
"tracking_url": "https://track.smartsend.io/example",
"tracking": {
"uuid": "66666666-6666-4666-8666-666666666666",
"tracking_number": "00340434161094015749",
"tracking_url": "https://track.smartsend.io/example",
"state": "InfoReceived",
"description": "Shipment information received.",
"estimated_delivery": null,
"delivered_at": null,
"returned_at": null,
"last_updated_at": "2026-09-16T10:00:02Z"
}
}
],
"total_net_amount": null,
"tax_amount": null,
"duty_amount": null,
"shipping_net_amount": null,
"shipping_tax_amount": null,
"content_type": null,
"uuid": "22222222-2222-4222-8222-222222222222",
"state": "booked",
"documents": [
{
"uuid": "44444444-4444-4444-8444-444444444444",
"name": "Shipping label",
"filename": "ORDER-1042-label.pdf",
"types": [
"label"
],
"format": "pdf",
"mime_type": "application/pdf",
"size_bytes": 18342,
"width": {
"value": 210,
"unit": "mm"
},
"height": {
"value": 297,
"unit": "mm"
},
"page_count": 1,
"url": "https://downloads.example.com/documents/label.pdf",
"url_expires_at": "2026-09-16T10:15:02Z",
"description": "Print and attach the label.",
"source": {
"type": "shipment",
"uuid": "22222222-2222-4222-8222-222222222222"
},
"print_status": null,
"created_at": "2026-09-16T10:00:02Z",
"updated_at": "2026-09-16T10:00:02Z"
}
],
"qr_codes": [],
"drop_off_codes": [],
"batch_uuid": null,
"error": null,
"created_at": "2026-09-16T10:00:00Z",
"updated_at": "2026-09-16T10:00:02Z",
"booked_at": "2026-09-16T10:00:02Z",
"cancelled_at": null,
"voided_at": null
},
{
"uuid": "22222222-2222-4222-8222-222222222223",
"deleted_at": "2026-09-16T10:00:12Z"
}
],
"links": {
"first": null,
"last": null,
"prev": null,
"next": null
},
"meta": {
"path": "https://api.smartsend.io/v2/teams/00000000-0000-4000-8000-000000000001/shipments",
"per_page": 100,
"next_cursor": null,
"prev_cursor": null,
"sync_until": "2026-09-16T10:01:00Z"
}
}{
"message": "Unauthenticated."
}{
"message": "This action is unauthorized."
}{
"message": "The requested resource was not found."
}{
"message": "The given data was invalid.",
"errors": {
"field_name": [
"This field is required."
]
}
}{
"message": "Too Many Attempts."
}{
"message": "Server Error"
}{
"message": "Service Unavailable"
}List and synchronise shipments
Returns current Shipment representations using cursor pagination. Newest-first by default. For incremental sync follow all links in the fixed update window, persist meta.sync_until only after completion, then use overlap and UUID upserts on the next round. Not a lossless history. Tracking/print updates do not advance Shipment.updated_at. Minimal deletion markers are opt-in; combining include_deleted with carrier/service/state/identifier/reference/tracking_number/batch filters returns 422.
curl --request GET \
--url https://api.smartsend.io/v2/teams/{teamUuid}/shipments \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.smartsend.io/v2/teams/{teamUuid}/shipments"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.smartsend.io/v2/teams/{teamUuid}/shipments', 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://api.smartsend.io/v2/teams/{teamUuid}/shipments",
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: Bearer <token>"
],
]);
$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://api.smartsend.io/v2/teams/{teamUuid}/shipments"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.smartsend.io/v2/teams/{teamUuid}/shipments")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.smartsend.io/v2/teams/{teamUuid}/shipments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"currency": "DKK",
"weight_unit": "g",
"dimension_unit": "cm",
"invoice_number": null,
"reference": "ORDER-1042",
"identifier": "shop-order-1042",
"uri": null,
"delivery": {
"carrier": {
"code": "postnord",
"name": "PostNord",
"logo_url": null,
"icon_url": null
},
"last_mile_carrier": {
"code": "postnord",
"name": "PostNord",
"logo_url": null,
"icon_url": null
},
"service_code": "postnord_agent",
"service_name": "Service point",
"is_pickup": true,
"is_return": false,
"addons": [],
"pickup_point": {
"uuid": "99999999-9999-4999-8999-999999999999",
"carrier_code": "postnord",
"code": "12345",
"name": "Example Parcel Shop",
"address": {
"address_lines": [
"Eksempelvej 20"
],
"postal_code": "8000",
"city": "Aarhus C",
"country": "DK",
"administrative_area": null
}
},
"delivery_window": null,
"incoterm": null
},
"parties": {
"merchant": {
"reference": null,
"identifier": null,
"uri": null,
"address": {
"address_lines": [
"Eksempelgade 1"
],
"postal_code": "2100",
"city": "Copenhagen",
"country": "DK",
"administrative_area": null
},
"contact": {
"name_lines": [
"Example Shop"
],
"company": "Example Shop",
"email": "shop@example.com",
"phone": "+4587654321"
},
"identifiers": null
},
"customer": {
"reference": null,
"identifier": null,
"uri": null,
"address": {
"address_lines": [
"Eksempelvej 10"
],
"postal_code": "8000",
"city": "Aarhus C",
"country": "DK",
"administrative_area": null
},
"contact": {
"name_lines": [
"Example Customer"
],
"company": null,
"email": "customer@example.com",
"phone": "+4512345678"
},
"identifiers": null
}
},
"parcels": [
{
"reference": "ORDER-1042-1",
"identifier": "shop-parcel-1",
"freetext": null,
"gross_weight": 1500,
"length": 30,
"width": 20,
"height": 15,
"total_net_amount": null,
"tax_amount": null,
"duty_amount": null,
"items": [],
"uuid": "33333333-3333-4333-8333-333333333333",
"tracking_number": "00340434161094015749",
"tracking_url": "https://track.smartsend.io/example",
"tracking": {
"uuid": "66666666-6666-4666-8666-666666666666",
"tracking_number": "00340434161094015749",
"tracking_url": "https://track.smartsend.io/example",
"state": "InfoReceived",
"description": "Shipment information received.",
"estimated_delivery": null,
"delivered_at": null,
"returned_at": null,
"last_updated_at": "2026-09-16T10:00:02Z"
}
}
],
"total_net_amount": null,
"tax_amount": null,
"duty_amount": null,
"shipping_net_amount": null,
"shipping_tax_amount": null,
"content_type": null,
"uuid": "22222222-2222-4222-8222-222222222222",
"state": "booked",
"documents": [
{
"uuid": "44444444-4444-4444-8444-444444444444",
"name": "Shipping label",
"filename": "ORDER-1042-label.pdf",
"types": [
"label"
],
"format": "pdf",
"mime_type": "application/pdf",
"size_bytes": 18342,
"width": {
"value": 210,
"unit": "mm"
},
"height": {
"value": 297,
"unit": "mm"
},
"page_count": 1,
"url": "https://downloads.example.com/documents/label.pdf",
"url_expires_at": "2026-09-16T10:15:02Z",
"description": "Print and attach the label.",
"source": {
"type": "shipment",
"uuid": "22222222-2222-4222-8222-222222222222"
},
"print_status": null,
"created_at": "2026-09-16T10:00:02Z",
"updated_at": "2026-09-16T10:00:02Z"
}
],
"qr_codes": [],
"drop_off_codes": [],
"batch_uuid": null,
"error": null,
"created_at": "2026-09-16T10:00:00Z",
"updated_at": "2026-09-16T10:00:02Z",
"booked_at": "2026-09-16T10:00:02Z",
"cancelled_at": null,
"voided_at": null
},
{
"uuid": "22222222-2222-4222-8222-222222222223",
"deleted_at": "2026-09-16T10:00:12Z"
}
],
"links": {
"first": null,
"last": null,
"prev": null,
"next": null
},
"meta": {
"path": "https://api.smartsend.io/v2/teams/00000000-0000-4000-8000-000000000001/shipments",
"per_page": 100,
"next_cursor": null,
"prev_cursor": null,
"sync_until": "2026-09-16T10:01:00Z"
}
}{
"message": "Unauthenticated."
}{
"message": "This action is unauthorized."
}{
"message": "The requested resource was not found."
}{
"message": "The given data was invalid.",
"errors": {
"field_name": [
"This field is required."
]
}
}{
"message": "Too Many Attempts."
}{
"message": "Server Error"
}{
"message": "Service Unavailable"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
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.
"da-DK, da;q=0.9, en;q=0.8"
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.
1 - 64^[A-Za-z0-9._-]{1,64}$Path Parameters
Team uuid. All resources are scoped to this team.
Query Parameters
Filter by carrier code.
Filter by composite service code.
Exact parcel tracking number.
Filter by current shipment state. Avoid mutable state filters during complete synchronisation. pending: accepted in an open batch. queued: waiting to start booking. booking: the carrier/document/code workflow is running. booked: carrier accepted and all required documents/codes are ready. failed: the workflow failed or reached its final deadline. cancelling: cancellation running. cancelled: cancelled internally without confirmed carrier cancellation; also used for unstarted batch members stopped before booking. voided: internally cancelled and carrier cancellation confirmed. A rare late success may change failed to booked or cancelled to voided. Delivery status belongs to tracking.
pending, queued, booking, booked, failed, cancelling, cancelled, voided Exact private shipment reference. Multiple shipments may match.
Exact public shipment reference. Multiple shipments may match.
Members of the specified batch.
Inclusive lower creation boundary.
Inclusive upper creation boundary.
Inclusive lower lifecycle-update boundary. Uses updated_at ordering.
Inclusive fixed upper boundary. On the first sync page the server assigns this when omitted and returns meta.sync_until; every next link retains it.
Include minimal DeletedShipment markers for synchronisation; requires updated_since. Only time filters are permitted with this flag. Deletion advances the internal ordering timestamp. Ordinary GET still returns 404.
Default -created_at, or updated_at when update filters are supplied. Update filters require updated_at sorting. Internal unique ID is the non-null tie-breaker.
-created_at, created_at, updated_at Opaque cursor returned by this endpoint. Omit it for the first page. Keep all filters, sort order and per_page unchanged within a page sequence. For tracking polls, use the documented resume_cursor once next is null.
1Maximum number of resources per page.
1 <= x <= 1000Response
Current shipments or requested deletion markers.
Current immutable booking input plus evolving lifecycle and results. Each shipment has one logical booking. Full event and print histories are retrieved through their own paginated endpoints. A failed document workflow may still have a carrier booking; never blindly rebook such a result.
- Option 1
- Option 2
Show child attributes
Show child attributes
Navigation links for a cursor-paginated collection. Follow next or prev with GET; returned URLs preserve the selected filters, sort order, page size and sync boundary where applicable.
Show child attributes
Show child attributes
Cursor pagination metadata with the additional sync_until boundary for shipment synchronisation.
Show child attributes
Show child attributes
Was this page helpful?