> ## 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.

# Listar órdenes de tienda

> Lista las órdenes de una tienda específica. Igual que Listar órdenes, acotado a una tienda por path.

La variante anidada de [Listar órdenes](/es/api-reference/list-orders): la tienda se identifica por
el path param `{storeId}` en lugar de un filtro de query. El resto de los query params — paginación,
filtros y [projection de campos](/es/api-reference/list-orders#projection-de-campos) — se comportan igual.

El guard de tenant garantiza que un `storeId` de otro account/vendor devuelva una lista vacía —
nunca órdenes de otro tenant.

## Autenticación

<ParamField header="x-api-key" type="string" required>
  Tu API key de Fire con scope `orders:read`. La key **debe ser vendor-scoped** — las keys sin
  `vendorId` se rechazan con `403`.
</ParamField>

## Path params

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

## Query params

<Info>El account y el vendor se derivan de tu API key (vendor-scoped) — no se envían por query.</Info>

<ParamField query="fields" type="string">
  Projection — ver [Projection de campos](/es/api-reference/list-orders#projection-de-campos).
</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">Día de negocio exacto, `YYYY-MM-DD`.</ParamField>
<ParamField query="dateFrom" type="string">Inicio del rango, `YYYY-MM-DD`.</ParamField>
<ParamField query="dateTo" type="string">Fin del rango, `YYYY-MM-DD`.</ParamField>
<ParamField query="dateFilterMode" type="string" default="business_day">`business_day` o `created_at`.</ParamField>
<ParamField query="tzOffset" type="string" default="+00:00">Offset de timezone para el modo `created_at`.</ParamField>
<ParamField query="channel" type="string">Código de canal.</ParamField>
<ParamField query="fulfillmentMethod" type="string">Código de servicio de fulfillment.</ParamField>
<ParamField query="paymentMethod" type="string">Código de método de pago.</ParamField>
<ParamField query="orderCode" type="string">Match parcial sobre order code.</ParamField>
<ParamField query="search" type="string">UUID exacto, o external order id / order code parcial.</ParamField>
<ParamField query="page" type="integer" default="1">Número de página (base 1).</ParamField>
<ParamField query="size" type="integer" default="20">Tamaño de página (1–100).</ParamField>

## Petición

<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: <tu_api_key>
  ```
</RequestExample>

## Respuesta

Mismo shape que [Listar órdenes](/es/api-reference/list-orders): `{ orders, pagination }`.

Para ver cómo viene el cobro de cada orden, proyectá `settlement` — ver
[Progreso del cobro](/es/api-reference/list-orders#progreso-del-cobro-settlement-y-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>

## Relacionado

<CardGroup cols={2}>
  <Card title="Listar órdenes" icon="receipt" href="/es/api-reference/list-orders">
    Lista todas las órdenes de tu account y vendor.
  </Card>

  <Card title="Obtener tienda" icon="store" href="/es/api-reference/get-store">
    Lee la tienda a la que pertenece este listado.
  </Card>
</CardGroup>