Skip to main content
GET
/
store
/
order-groups
/
{id}
curl 'http://localhost:9000/store/order-groups/og_01JB2KE7NP' \
  -H 'x-publishable-api-key: pk_01JB2K3XYZ' \
  -H 'Authorization: Bearer <customer_token>'
{
  "order_group": {
    "id": "og_01JB2KE7NP",
    "customer_id": "cus_01JB2KE8QR",
    "seller_count": 2,
    "total": 9900,
    "orders": [
      {
        "id": "order_01JB2KH1WX",
        "seller_id": "sel_01JB2K8A1B",
        "items": [{ "id": "ordli_01JB2KH2YZ", "title": "M", "quantity": 1 }]
      },
      {
        "id": "order_01JB2KH3AB",
        "seller_id": "sel_01JB2KF9ST",
        "items": [{ "id": "ordli_01JB2KH4CD", "title": "One Size", "quantity": 1 }]
      }
    ],
    "created_at": "2026-05-01T10:05:00.000Z",
    "updated_at": "2026-05-01T10:05:00.000Z"
  }
}
Returns a single order group with its per-seller child orders; order groups belonging to another customer return a 404.
Customer authentication is required (Authorization: Bearer <customer_token> or a session cookie).

Path parameters

id
string
required
The order group’s ID.

Query parameters

fields
string
Comma-separated fields to include; only fields from the route’s allowed list are accepted.

Response

order_group
object
curl 'http://localhost:9000/store/order-groups/og_01JB2KE7NP' \
  -H 'x-publishable-api-key: pk_01JB2K3XYZ' \
  -H 'Authorization: Bearer <customer_token>'
{
  "order_group": {
    "id": "og_01JB2KE7NP",
    "customer_id": "cus_01JB2KE8QR",
    "seller_count": 2,
    "total": 9900,
    "orders": [
      {
        "id": "order_01JB2KH1WX",
        "seller_id": "sel_01JB2K8A1B",
        "items": [{ "id": "ordli_01JB2KH2YZ", "title": "M", "quantity": 1 }]
      },
      {
        "id": "order_01JB2KH3AB",
        "seller_id": "sel_01JB2KF9ST",
        "items": [{ "id": "ordli_01JB2KH4CD", "title": "One Size", "quantity": 1 }]
      }
    ],
    "created_at": "2026-05-01T10:05:00.000Z",
    "updated_at": "2026-05-01T10:05:00.000Z"
  }
}