List freight shipments
Changed onReturn the freight shipments on your account, most recently created first. Results are paginated.
Request
- Base URLhttps://api.shipstation.com
- URLhttps://api.shipstation.com/v2/freight/shipments
- AuthAPI key in header api-key
Query parameters
The page of results to return. Values below 1 are treated as 1.
The number of freight shipments to return per page. Values above 500 are capped at 500.
Only return freight shipments created on or after this date and time, in ISO 8601 format. The start of the range is inclusive.
Only return freight shipments created before this date and time, in ISO 8601 format. The end of the range is exclusive.
Response
The request was a success.
Example response
{
"shipments": [
{
"freight_shipment_id": "se-28529731",
"shipment_id": "se-28529731",
"freight_provider_account_id": "se-28529731",
"freight_provider_code": "UNISHIPPERS",
"status": "booked",
"bol_number": "BOL-20260417-4821",
"pro_number": "072-51293847",
"confirmation_number": "FXFE-PU-884215",
"created_at": "2026-09-18T14:54:44Z",
"documents": [
{
"type": "bill_of_lading",
"url": "/v2/downloads/10/a1b2c3d4e5f6/bill_of_lading.pdf"
}
],
"notifications": [
{
"events": [
"booked",
"in_transit"
],
"email_addresses": [
"logistics@example.com"
]
}
]
}
],
"total": 137,
"page": 1,
"page_size": 25,
"pages": 6
}Changes
- info
added the optional property
//to the response with the status
- info
- warning
added the new
bring_your_own_label_not_supportedenum value to the//response property for the response status - warning
added the new
multiple_sales_ordersenum value to the//response property for the response status - warning
added the new
sales_order_link_requiredenum value to the//response property for the response status
- warning