> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# List store orders

> List the orders of a specific store. Same as List orders, scoped to one store by path.

The nested variant of [List orders](/en/api-reference/list-orders): the store is identified by the
`{storeId}` path parameter instead of a query filter. All other query parameters — pagination,
filters and [field projection](/en/api-reference/list-orders#field-projection) — behave the same.

The tenant guard guarantees that a `storeId` belonging to another account/vendor returns an empty
list — never another tenant's orders.

## Authentication

<ParamField header="x-api-key" type="string" required>
  Your Fire API key with the `orders:read` scope. The key **must be vendor-scoped** — keys without a
  `vendorId` are rejected with `403`.
</ParamField>

## Path parameters

<ParamField path="storeId" type="string" required>
  Store UUID (`stores.id`).
</ParamField>

## Query parameters

<Info>The account and vendor are derived from your API key (vendor-scoped) — you do not send them as query params.</Info>

<ParamField query="fields" type="string">
  Projection — see [Field projection](/en/api-reference/list-orders#field-projection).
</ParamField>

<ParamField query="status" type="string">`OPEN`, `COMPLETED`, `FORCE_CLOSED`, `CANCELLED`.</ParamField>
<ParamField query="paymentStatus" type="string">`PENDING`, `SUCCEEDED`, `FAILED`.</ParamField>
<ParamField query="businessDayDate" type="string">Exact business day, `YYYY-MM-DD`.</ParamField>
<ParamField query="dateFrom" type="string">Range start, `YYYY-MM-DD`.</ParamField>
<ParamField query="dateTo" type="string">Range end, `YYYY-MM-DD`.</ParamField>
<ParamField query="dateFilterMode" type="string" default="business_day">`business_day` or `created_at`.</ParamField>
<ParamField query="tzOffset" type="string" default="+00:00">Timezone offset for `created_at` mode.</ParamField>
<ParamField query="channel" type="string">Channel code.</ParamField>
<ParamField query="fulfillmentMethod" type="string">Fulfillment service code.</ParamField>
<ParamField query="paymentMethod" type="string">Payment method code.</ParamField>
<ParamField query="orderCode" type="string">Partial match on order code.</ParamField>
<ParamField query="search" type="string">Exact UUID, or partial external order id / order code.</ParamField>
<ParamField query="page" type="integer" default="1">Page number (1-based).</ParamField>
<ParamField query="size" type="integer" default="20">Page size (1–100).</ParamField>

## Request

<RequestExample>
  ```http theme={null}
  GET https://api.fire.rest/api/v1/fire/external/stores/550e8400-e29b-41d4-a716-446655440000/orders?size=20
  x-api-key: <your_api_key>
  ```
</RequestExample>

## Response

Same shape as [List orders](/en/api-reference/list-orders): `{ orders, pagination }`.

To see how each order's collection is going, project `settlement` — see
[Payment progress](/en/api-reference/list-orders#payment-progress-settlement-and-payments).

<ResponseExample>
  ```json 200 theme={null}
  {
    "orders": [
      {
        "id": "7e2b8c10-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
        "orderCode": "OC-1024",
        "storeId": "550e8400-e29b-41d4-a716-446655440000",
        "status": "COMPLETED",
        "paymentStatus": "SUCCEEDED",
        "channel": "APP",
        "businessDayDate": "2026-07-01",
        "createdAt": "2026-07-01T14:03:00Z",
        "updatedAt": "2026-07-01T14:20:00Z"
      }
    ],
    "pagination": { "page": 1, "size": 20, "total": 1, "totalPages": 1 }
  }
  ```
</ResponseExample>

## Related

<CardGroup cols={2}>
  <Card title="List orders" icon="receipt" href="/en/api-reference/list-orders">
    List all orders of your account and vendor.
  </Card>

  <Card title="Get store" icon="store" href="/en/api-reference/get-store">
    Read the store this listing belongs to.
  </Card>
</CardGroup>
