Retrieve a list of shipments

GET {{baseUrl}}/integrations/:id/shipments?cursor=<string>&start_date=<date>&end_date=<date>&external_order_ids=<string>&external_order_ids=<string>&external_shipment_ids=<string>&external_shipment_ids=<string>&shipping_rules=<boolean>&order_number=<string>&sender_address=<integer>

Retrieving shipments from an integration

Via this endpoint, you can retrieve a list of orders that were imported from a specific webshop integration. Note that these orders are not affected by shipping rules at the time of retrieval, unless enabled explicitly. This endpoint is paginated, meaning that you can navigate through the results via the URLs provided within the next and previous fields.

Request Params

KeyDatatypeRequiredDescription
cursorstringThe cursor query string will be used as the pivot value to filter results. If no value is provided, the service must return the first page. The value is Base64 encoded GET parameters. example:
For a cursor string there are 3 possible parameters to encode:
  • o: Offset
  • r: Reverse
  • p: Position Combine into GET parameters. Example: r=1&p=300 Base 64 encoded it would become: cj0xJnA9MzAw GET parameter in url would be https://some.url.com/api/endpoint/?cursor=cj0xJnA9MzAw | | start_date | string | | Displays orders from the given start_date, including the set date. It defaults to one year ago. | | end_date | string | | Displays orders up to the given end_date, including the set date. It defaults to the current date. | | external_order_ids | string | | Filters results to shipments where their external_order_id matches one of the user provided ones. | | external_order_ids | string | | Filters results to shipments where their external_order_id matches one of the user provided ones. | | external_shipment_ids | string | | Filters results to shipments where their external_shipments_id matches one of the user provided ones. | | external_shipment_ids | string | | Filters results to shipments where their external_shipments_id matches one of the user provided ones. | | shipping_rules | string | | Enable shipping rules when retrieving orders. This will have an impact on the allowed_shipping_methods. | | order_number | string | | Filters results to shipments on order_number. | | sender_address | string | | Allows to specify a sender address id to display proper allowed_shipping_methods. |

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;next&quot;:&quot;\u003curi\u003e&quot;,&quot;previous&quot;:&quot;\u003curi\u003e&quot;,&quot;results&quot;:[{&quot;address&quot;:&quot;\u003cstring\u003e&quot;,&quot;address_2&quot;:&quot;\u003cstring\u003e&quot;,&quot;city&quot;:&quot;\u003cstring\u003e&quot;,&quot;company_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;country&quot;:&quot;MK&quot;,&quot;created_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;currency&quot;:&quot;USD&quot;,&quot;customs_invoice_nr&quot;:&quot;\u003cstring\u003e&quot;,&quot;customs_shipment_type&quot;:1,&quot;email&quot;:&quot;\u003cemail\u003e&quot;,&quot;external_order_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;external_shipment_id&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;house_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;order_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;order_status&quot;:null,&quot;parcel_items&quot;:[{&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;quantity&quot;:&quot;\u003cinteger\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;,&quot;hs_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;origin_country&quot;:&quot;LU&quot;,&quot;product_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;properties&quot;:{&quot;veniam_7&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;esse0&quot;:&quot;\u003cstring,null\u003e&quot;},&quot;sku&quot;:&quot;\u003cstring\u003e&quot;,&quot;weight&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;mid_code&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;material_content&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;intended_use&quot;:&quot;\u003cstring,null\u003e&quot;},{&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;quantity&quot;:&quot;\u003cinteger\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;,&quot;hs_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;origin_country&quot;:&quot;ES&quot;,&quot;product_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;properties&quot;:{&quot;et5c&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;voluptate3&quot;:&quot;\u003cstring,null\u003e&quot;},&quot;sku&quot;:&quot;\u003cstring\u003e&quot;,&quot;weight&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;mid_code&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;material_content&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;intended_use&quot;:&quot;\u003cstring,null\u003e&quot;}],&quot;payment_status&quot;:null,&quot;postal_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;shipping_method_checkout_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;telephone&quot;:&quot;\u003cstring\u003e&quot;,&quot;to_post_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;to_service_point&quot;:&quot;\u003cinteger,null\u003e&quot;,&quot;to_state&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;updated_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;shipment_created_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;shipment_updated_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;allowed_shipping_methods&quot;:[&quot;\u003cinteger\u003e&quot;,&quot;\u003cinteger\u003e&quot;],&quot;barcode&quot;:&quot;\u003cstring\u003e&quot;,&quot;integration&quot;:&quot;\u003cinteger\u003e&quot;,&quot;sender_address&quot;:&quot;\u003cinteger,null\u003e&quot;,&quot;shipment_uuid&quot;:&quot;\u003cuuid\u003e&quot;,&quot;shipping_method&quot;:&quot;\u003cinteger,null\u003e&quot;,&quot;total_order_value&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;weight&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;checkout_payload&quot;:{&quot;sender_address_id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;shipping_product&quot;:{},&quot;delivery_method_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;delivery_method_data&quot;:{&quot;delivery_date&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;formatted_delivery_date&quot;:&quot;\u003cstring\u003e&quot;,&quot;parcel_handover_date&quot;:&quot;\u003cdateTime\u003e&quot;}},&quot;width&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;height&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;length&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;customs_details&quot;:{&quot;discount_granted&quot;:{&quot;value&quot;:&quot;405.81749304775&quot;,&quot;currency&quot;:&quot;\u003cstring,null\u003e&quot;},&quot;insurance_costs&quot;:{&quot;value&quot;:&quot;5531316290&quot;,&quot;currency&quot;:&quot;\u003cstring,null\u003e&quot;},&quot;freight_costs&quot;:{&quot;value&quot;:&quot;875199&quot;,&quot;currency&quot;:&quot;\u003cstring,null\u003e&quot;},&quot;other_costs&quot;:{&quot;value&quot;:&quot;6977772703&quot;,&quot;currency&quot;:&quot;\u003cstring,null\u003e&quot;},&quot;tax_numbers&quot;:{&quot;sender&quot;:[{&quot;name&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;country_code&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;value&quot;:&quot;\u003cstring,null\u003e&quot;},{&quot;name&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;country_code&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;value&quot;:&quot;\u003cstring,null\u003e&quot;}],&quot;receiver&quot;:[{&quot;name&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;country_code&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;value&quot;:&quot;\u003cstring,null\u003e&quot;},{&quot;name&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;country_code&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;value&quot;:&quot;\u003cstring,null\u003e&quot;}],&quot;importer_of_records&quot;:[{&quot;name&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;country_code&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;value&quot;:&quot;\u003cstring,null\u003e&quot;},{&quot;name&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;country_code&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;value&quot;:&quot;\u003cstring,null\u003e&quot;}]}}},{&quot;address&quot;:&quot;\u003cstring\u003e&quot;,&quot;address_2&quot;:&quot;\u003cstring\u003e&quot;,&quot;city&quot;:&quot;\u003cstring\u003e&quot;,&quot;company_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;country&quot;:&quot;FO&quot;,&quot;created_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;currency&quot;:&quot;EUR&quot;,&quot;customs_invoice_nr&quot;:&quot;\u003cstring\u003e&quot;,&quot;customs_shipment_type&quot;:0,&quot;email&quot;:&quot;\u003cemail\u003e&quot;,&quot;external_order_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;external_shipment_id&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;house_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;order_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;order_status&quot;:null,&quot;parcel_items&quot;:null,&quot;payment_status&quot;:{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;},&quot;postal_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;shipping_method_checkout_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;telephone&quot;:&quot;\u003cstring\u003e&quot;,&quot;to_post_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;to_service_point&quot;:&quot;\u003cinteger,null\u003e&quot;,&quot;to_state&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;updated_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;shipment_created_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;shipment_updated_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;allowed_shipping_methods&quot;:[&quot;\u003cinteger\u003e&quot;,&quot;\u003cinteger\u003e&quot;],&quot;barcode&quot;:&quot;\u003cstring\u003e&quot;,&quot;integration&quot;:&quot;\u003cinteger\u003e&quot;,&quot;sender_address&quot;:&quot;\u003cinteger,null\u003e&quot;,&quot;shipment_uuid&quot;:&quot;\u003cuuid\u003e&quot;,&quot;shipping_method&quot;:&quot;\u003cinteger,null\u003e&quot;,&quot;total_order_value&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;weight&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;checkout_payload&quot;:{&quot;sender_address_id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;shipping_product&quot;:{},&quot;delivery_method_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;delivery_method_data&quot;:{&quot;delivery_date&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;formatted_delivery_date&quot;:&quot;\u003cstring\u003e&quot;,&quot;parcel_handover_date&quot;:&quot;\u003cdateTime\u003e&quot;}},&quot;width&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;height&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;length&quot;:&quot;\u003cstring,null\u003e&quot;,&quot;customs_details&quot;:null}]}