# List freight shipments

Return the freight shipments on your account, most recently created first. Results are paginated.

Endpoint: GET /v1/freight/shipments
Version: 1.1.202604070904
Security: api_key

## Query parameters:

  - `page` (integer)
    The page of results to return. Values below 1 are treated as 1.
    Example: 1

  - `page_size` (integer)
    The number of freight shipments to return per page. Values above 500 are capped at 500.
    Example: 50

  - `created_at_start` (string)
    Only return freight shipments created on or after this date/time.
    Example: "2019-03-12T19:24:13.657Z"

  - `created_at_end` (string)
    Only return freight shipments created on or before this date/time.
    Example: "2019-03-12T19:24:13.657Z"

## Response 200 fields (application/json):

  - `shipments` (array)
    The freight shipments on this page.

  - `shipments.freight_shipment_id` (string)
    The identifier of the freight shipment.
    Example: "se-28529731"

  - `shipments.freight_provider_account_id` (string)
    The freight provider account the shipment was booked through.
    Example: "se-28529731"

  - `shipments.freight_provider_code` (string)
    The code of the freight provider the shipment was booked through.
    Example: "UNISHIPPERS"

  - `shipments.status` (string)
    The current status of the shipment.
    Enum: "pending", "quoted", "booked", "in_transit", "delivered", "cancelled", "exception"

  - `shipments.bol_number` (string,null)
    The Bill of Lading number assigned to the shipment.
    Example: "BOL-20260417-4821"

  - `shipments.pro_number` (string,null)
    The carrier's PRO number for the shipment, or null until the carrier assigns one.
    Example: "072-51293847"

  - `shipments.confirmation_number` (string,null)
    The carrier's pickup confirmation number. null when the carrier did not return one.
    Example: "FXFE-PU-884215"

  - `shipments.created_at` (string)
    The date and time the freight shipment was created, in UTC.
    Example: "2026-09-18T14:54:44Z"

  - `shipments.documents` (array,null)
    The documents stored for the shipment, each with a download URL. null when no documents have been stored yet.

  - `shipments.documents.type` (string)
    The type of document.
    Enum: "bill_of_lading", "bol_pallet_label_combined", "certificate_of_insurance", "certificate_of_insurance_instructions", "certificate_of_origin_us", "certificate_of_origin_usmca", "certificate_of_origin_usmca_instructions", "international_commercial_invoice", "packing_list", "pallet_label", "pallet_label_4x6", "proof_of_delivery", "quote", "weight_and_inspection"

  - `shipments.documents.url` (string,null)
    The path to download the document as a PDF, relative to the API host. Resolve it against https://api.shipengine.com to get the full URL.
    Example: "/v1/downloads/10/a1b2c3d4e5f6/bill_of_lading.pdf"

  - `total` (integer)
    The total number of freight shipments on the account.
    Example: 137

  - `page` (integer)
    The page of results returned.
    Example: 1

  - `page_size` (integer)
    The number of freight shipments per page.
    Example: 25

  - `pages` (integer)
    The total number of pages available.
    Example: 6

## Response 400 fields (application/json):

  - `request_id` (string, required)
    A UUID that uniquely identifies the request id.
This can be given to the support team to help debug non-trivial issues that may occur
    Example: "aa3d8e8e-462b-4476-9618-72db7f7b7009"

  - `errors` (array, required)
    The errors associated with the failed API call

  - `errors.error_source` (string, required)
    The source of the error, as indicated by the name this informs us if the API call failed because of the
carrier, the order source, or the ShipEngine API itself.
    Enum: "carrier", "order_source", "shipengine"

  - `errors.error_type` (string, required)
    The type of error
    Enum: "account_status", "business_rules", "validation", "security", "system", "integrations"

  - `errors.error_code` (string, required)
    The error code specified for the failed API Call
    Enum: "auto_fund_not_supported", "batch_cannot_be_modified", "carrier_conflict", "carrier_disconnected", "carrier_not_connected", "carrier_not_supported", "confirmation_not_supported", "default_warehouse_cannot_be_deleted", "field_conflict", "field_value_required", "forbidden", "identifier_conflict", "identifiers_must_match", "insufficient_funds", "invalid_address", "invalid_billing_plan", "invalid_field_value", "invalid_identifier", "invalid_status", "invalid_string_length", "label_images_not_supported", "meter_failure", "order_source_not_active", "rate_limit_exceeded", "refresh_not_supported", "request_body_required", "return_label_not_supported", "settings_not_supported", "subscription_inactive", "terms_not_accepted", "tracking_not_supported", "trial_expired", "unauthorized", "unknown", "unspecified", "verification_failure", "warehouse_conflict", "webhook_event_type_conflict", "customs_items_required", "incompatible_paired_labels", "invalid_charge_event", "invalid_object", "no_rates_returned", "file_not_found", "shipping_rule_not_found", "service_not_determined", "no_rates_returned", "funding_source_registration_in_progress", "insurance_failure", "funding_source_missing_configuration", "funding_source_error", "freight_connection_inactive", "freight_provider_id_required", "freight_provider_already_connected", "freight_shipment_not_found", "freight_tracking_not_available", "freight_tracking_not_found", "freight_shipment_not_batchable"

  - `errors.message` (string, required)
    An error message associated with the failed API call
    Example: "Body of request cannot be null."

  - `errors.carrier_id` (string)
    A string that uniquely identifies the carrier that generated the error.
    Example: "se-28529731"

  - `errors.carrier_code` (string)
    The name of the shipping carrier that generated the error, such as fedex, dhl_express, stamps_com, etc.
    Example: "dhl_express"

  - `errors.field_name` (string)
    The name of the field that caused the error
    Example: "shipment.ship_to.phone_number"