curl --request POST \
  --url 'https://clarus-api.com/graphql#ListShipments' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Clarus-Subdomain: <api-key>' \
  --data '
{
  "query": "query($filter: ShipmentFilterType) { shipments { all(filter: $filter) { edges { node { id reference name status delivery_notes collection_datetime label_filename packages_count carrier { id code name } carrier_service { id code name } warehouse { id code name } } } } } }"
}
'

import requests

url = "https://clarus-api.com/graphql#ListShipments"

payload = { "query": "query($filter: ShipmentFilterType) { shipments { all(filter: $filter) { edges { node { id reference name status delivery_notes collection_datetime label_filename packages_count carrier { id code name } carrier_service { id code name } warehouse { id code name } } } } } }" }
headers = {
    "Authorization": "Bearer <token>",
    "X-Clarus-Subdomain": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'X-Clarus-Subdomain': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: 'query($filter: ShipmentFilterType) { shipments { all(filter: $filter) { edges { node { id reference name status delivery_notes collection_datetime label_filename packages_count carrier { id code name } carrier_service { id code name } warehouse { id code name } } } } } }'
  })
};

fetch('https://clarus-api.com/graphql#ListShipments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "shipments": {
      "all": {
        "edges": [
          {
            "node": {
              "id": "1",
              "reference": "SH-001",
              "name": "Shipment to Customer A",
              "status": "dispatched",
              "delivery_notes": null,
              "collection_datetime": "2026-03-10T14:00:00Z",
              "label_filename": "label-SH-001.pdf",
              "packages_count": 2,
              "carrier": {
                "id": "1",
                "code": "DPD",
                "name": "DPD"
              },
              "carrier_service": {
                "id": "1",
                "code": "NEXT",
                "name": "Next Day"
              },
              "warehouse": {
                "id": "1",
                "code": "WH1",
                "name": "Main Warehouse"
              }
            }
          }
        ]
      }
    }
  }
}

{
  "error": "<string>"
}