Get order · Bigblue Developers

POST/bigblue.storeapi.v1.PublicAPI/GetOrder

Returns one order with its status, shipped_packages, tracking_number and tracking_url.

You can only look up orders by Bigblue id. To find an order by your own reference, use the external_order filter on ListTrackings.

Tracking

If an order has several parcels, tracking_number and tracking_url belong to the parcel furthest along in delivery. Cancelled fulfillments are ignored. To get every parcel and its events, use ListTrackings.

Request body

idstringrequired

Bigblue order ID.

Pattern^[A-Za-z0-9]{12}$

Responses

200The order.

orderOrder

The order with its status, packages and tracking.

400The ID isn't 12 letters or digits.

{
  "code": "invalid_argument",
  "msg": "id value does not match regex pattern `^[[:alnum:]]{12}$`",
  "meta": { "argument": "id" }
}

404No order with this ID exists.

{ "code": "not_found", "msg": "order not found" }

POST/bigblue.storeapi.v1.PublicAPI/GetOrder

Request

{ "id": "BGBL0K3M9XQ2" }

200: shipped

{
  "order": {
    "id": "BGBL0K3M9XQ2",
    "external_id": "web-10231",
    "store": "i_bgbl0001",
    "submit_time": "2026-03-14T09:30:00Z",
    "currency": "EUR",
    "line_items": [
      {
        "product": "BGBL-ESPSRT-SMAL",
        "quantity": 2,
        "unit_price": "24.9",
        "unit_tax": "4.15"
      }
    ],
    "shipping_price": "4.9",
    "total": "58.82",
    "status": { "code": "SHIPPED" },
    "tracking_number": "6A12345678901",
    "tracking_url": "https://track.bigblue.co/BGBL0K3M9XQ2",
    "shipped_packages": [
      {
        "id": "BGBL0K3M9XQ2F1P1",
        "tracking_number": "6A12345678901",
        "weight": 480,
        "items": [
          { "product": "BGBL-ESPSRT-SMAL", "quantity": 2 }
        ]
      }
    ]
  }
}

200: bundle order

{
  "order": {
    "id": "BGBL7Q2M0XZ8",
    "status": { "code": "SHIPPED" },
    "line_items": [
      {
        "product": "BGBLBU-KITSTA-2024",
        "quantity": 1,
        "unit_price": "59",
        "unit_tax": "9.83"
      }
    ],
    "shipped_packages": [
      {
        "id": "BGBL7Q2M0XZ8F1P1",
        "tracking_number": "6A98765432109",
        "weight": 1240,
        "items": [
          { "product": "BGBL-MUGCLA-WHIT", "quantity": 2 },
          { "product": "BGBL-ESPSRT-SMAL", "quantity": 1 }
        ]
      }
    ]
  }
}

The line item is the bundle. The package lists its components.