Skip to main content

Get order details

note

The id in this example is a placeholder — use a real one from the orders query.

Use order query to retrieve a single order by ID. This example returns the order scalar fields together with its lines, billing details, shippings and their warehouse. The order and shipping statuses are explained in Order and shipping statuses. Lines of kind coupon carry an order-level discount as a negative price; line-level discounts are already included in discountedUnitaryPrice.

Response
{
  "data": {
    "order": {
      "id": "12345",
      "createdAt": "2026-01-15T10:30:00.000Z",
      "updatedAt": "2026-01-15T10:35:00.000Z",
      "receivedAt": "2026-01-15T10:31:00.000Z",
      "paidAt": "2026-01-15T10:32:00.000Z",
      "number": "36351",
      "deliveryId": "UWGDLUDLU",
      "status": "processing",
      "lines": [
        {
          "id": "987",
          "kind": "item",
          "quantity": 2,
          "sku": "SKU-1",
          "skuDescription": "Demo product",
          "number": "1",
          "originalUnitaryPrice": 100.0,
          "discountedUnitaryPrice": 90.0,
          "vatPercentage": 22.0,
          "unitaryVatAmount": 19.8
        }
      ],
      "billing": {
        "id": "456",
        "firstName": "Mario",
        "lastName": "Rossi",
        "email": "example@example.com",
        "address1": "Via Roma 1",
        "address2": null,
        "city": "Treviso",
        "zipCode": "31100",
        "province": "TV",
        "country": "Italy",
        "isoCountry": "IT",
        "companyName": "Company",
        "telephone": "0039000000000",
        "pec": "example@example.pec.it",
        "destinationCode": "ABC1234",
        "fiscalCode": "ABCDEFG00A00L407A",
        "vatNumber": "12345678901",
        "currency": "EUR",
        "exchangeRate": 1.0
      },
      "shippings": [
        {
          "id": "789",
          "email": "shipping@example.com",
          "address1": "Via Milano 2",
          "address2": "Scala B",
          "city": "Milano",
          "companyName": "Company",
          "country": "Italy",
          "firstName": "Mario",
          "isoCountry": "IT",
          "lastName": "Rossi",
          "province": "MI",
          "telephone": "0039111111111",
          "zipCode": "20100",
          "status": "in_transit",
          "fulfillmentStatus": "pending",
          "bookingStatus": "confirmed",
          "carrierName": "DHL",
          "trackingNumber": "IT2206513911",
          "trackingUrl": "https://track.example.test/IT2206513911",
          "warehouse": {
            "id": "12",
            "codes": ["MIL"],
            "internal": true
          }
        }
      ]
    }
  },
  "extensions": {
    "queryComplexity": 63,
    "bucketBalance": 9937,
    "bucketRestoreRate": 100
  }
}

Relevant permissions

The operations in this page require the following permissions on the API credentials — they are configured for you by Calicantus.

  • order:query:order
  • order:read
  • order_line:read
  • billing:read
  • shipping:read
  • warehouse:read