Get order fulfillment status

Endpoint: POST /v10/orders/fulfillment-status

Returns everything a help desk needs to answer "where is my order": who the order is for, what has been shipped per line, the shipments with their track & trace and whether the order can still be cancelled.

Parameter	Required	Default	Description
order_id	Yes, if no order_number or shopify_order_id is given		The ID of the order to get the fulfillment status for
order_number	Yes, if no order_id or shopify_order_id is given		The number of the order to get the fulfillment status for
shopify_order_id	Yes, if no order_id or order_number is given		The Shopify order ID of the order to get the fulfillment status for

tip

To find the orders of a customer from their email or phone number, use Get orders with the email or telephone filter.

Data of response

Parameter	Required	Default	Description
fulfillment_status.*	Yes		An fulfillment status object

Fulfillment status data

Parameter	Required	Default	Description
order_id	Yes		The ID of the order
order_number	Yes		The number of the order
type	Yes		The type of the order. Possible values: b2b, b2c
shopify_order_id		null	The Shopify order ID, if the order was imported from Shopify
fulfillment_status	Yes		The fulfillment status of the order. Possible values: open, being_packed, completed
can_cancel	Yes		Whether the order can be cancelled. Possible values: true, false
can_cancel_reason		null	The reason why the order cannot be cancelled. Possible values: shipment_completed, shipment_claimed, order_cancelled
customer		null	A customer object. null if the API user is not allowed to see the buyer of orders
delivery_address		null	A delivery address object. null if the API user is not allowed to see the delivery address of orders
lines	Yes		An array of objects line data
shipments	Yes		An array of objects shipment data

Customer data

For B2B orders the customer is taken from the customer card. For B2C orders the name, email and telephone are taken from the delivery address of the order, since that is where the consumer's details are.

Parameter	Required	Default	Description
customer_id		null	The ID of the customer
customer_number		null	The number of the customer
name		null	The name of the customer
email		null	The email of the customer
telephone		null	The telephone number of the customer
users	Yes	[]	An array of objects customer user data. The B2B users of the customer, who often write from their own email rather than the customer's. Always empty for B2C orders

Customer user data

Parameter	Required	Default	Description
name		null	The name of the user
email		null	The email of the user
telephone		null	The telephone number of the user

Delivery address data

Parameter	Required	Default	Description
name		null	The name of the receiver
att		null	The attention of the address
address		null	The first address line
address_2		null	The second address line
zip		null	The zip code
city		null	The city
region		null	The region
country		null	The country as ISO 3166-1 alpha-2 code
email		null	The email of the receiver
telephone		null	The telephone number of the receiver

Line data

Parameter	Required	Default	Description
order_line_id	Yes		The ID of the order line
sku		null	The SKU of the line
name		null	The product name including variant attributes, e.g. T-shirt / Black / M
quantity	Yes		The number of pieces ordered
shipped	Yes		The number of pieces shipped
remaining	Yes		The number of pieces not shipped yet
estimated_departure_date		null	The date the line is expected to leave the warehouse (ETD), as YYYY-MM-DD. Only available for accounts using sales order dates v2
estimated_delivery_date		null	The date the line is expected to be delivered (ETA), as YYYY-MM-DD. Only available for accounts using sales order dates v2

Shipment data

Parameter	Required	Default	Description
shipment_id	Yes		The ID of the shipment. Use it with Update shipment
shipment_number	Yes		The number of the shipment
status	Yes		The status of the shipment. See shipment status mapping
priority	Yes		Whether the shipment is prioritized in the warehouse
hold	Yes		Whether the shipment is on hold
shipping_method		null	The name of the shipping method (carrier) of the shipment
shipped_at		null	When the shipment was shipped, as ISO 8601. Only set for shipped shipments
colli	Yes		An array of objects colli data. Track & trace is returned as soon as it exists, also before the shipment is completed

Shipment status mapping

Status	Description
open	The shipment is waiting to be packed
locked	The shipment is locked and will not be packed until it is unlocked
being_packed	The warehouse has started packing the shipment. The order can no longer be cancelled
on_hold	The shipment has been put on hold by the warehouse
completed	The shipment has been shipped
cancelled	The shipment has been cancelled

Colli data

Parameter	Required	Default	Description
track_trace		null	The package code of the shipment
track_trace_link		null	A direct link to a track & trace page. If null Traede will attempt to generate this from track_trace and carrier
lines	Yes		An array of objects colli lines

Colli lines data

Parameter	Required	Default	Description
sku	Yes		The SKU of the line
ordered	Yes		The number of pieces ordered for this line
packed	Yes		The number of pieces packed for this line

Request example

POST /v10/orders/fulfillment-status

{
  "order_number": "1000"
}

Response example

{
  "fulfillment_status": {
    "order_id": 1,
    "order_number": "1000",
    "type": "b2c",
    "shopify_order_id": "5541239872",
    "fulfillment_status": "completed",
    "can_cancel": false,
    "can_cancel_reason": "shipment_completed",
    "customer": {
      "customer_id": 12,
      "customer_number": "WEBSHOP",
      "name": "Jane Consumer",
      "email": "jane@example.com",
      "telephone": "+45 12 34 56 78",
      "users": []
    },
    "delivery_address": {
      "name": "Jane Consumer",
      "att": null,
      "address": "Consumer street 1",
      "address_2": null,
      "zip": "2100",
      "city": "Copenhagen",
      "region": null,
      "country": "DK",
      "email": "jane@example.com",
      "telephone": "+45 12 34 56 78"
    },
    "lines": [
      {
        "order_line_id": 101,
        "sku": "1000-100-XS",
        "name": "T-shirt / Black / XS",
        "quantity": 1,
        "shipped": 1,
        "remaining": 0,
        "estimated_departure_date": "2026-11-02",
        "estimated_delivery_date": "2026-11-04"
      }
    ],
    "shipments": [
      {
        "shipment_id": 55,
        "shipment_number": "1000-1",
        "status": "completed",
        "priority": false,
        "hold": false,
        "shipping_method": "GLS",
        "shipped_at": "2026-11-02T14:31:00+00:00",
        "colli": [
          {
            "track_trace": "1234567890",
            "track_trace_link": "https://gls-group.eu/EU/en/parcel-tracking?match=1234567890",
            "lines": [
              {
                "sku": "1000-100-XS",
                "ordered": 1,
                "packed": 1
              }
            ]
          }
        ]
      }
    ]
  }
}