> ## 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 pedidos da loja

> Lista os pedidos de uma loja específica. Igual a Listar pedidos, restrito a uma loja por path.

A variante aninhada de [Listar pedidos](/pt/api-reference/list-orders): a loja é identificada pelo
path param `{storeId}` em vez de um filtro de query. Os demais query params — paginação, filtros e
[projeção de campos](/pt/api-reference/list-orders#projecao-de-campos) — comportam-se da mesma forma.

O guard de tenant garante que um `storeId` de outro account/vendor retorne uma lista vazia — nunca
pedidos de outro tenant.

## Autenticação

<ParamField header="x-api-key" type="string" required>
  Sua API key do Fire com scope `orders:read`. A key **deve ser vendor-scoped** — keys sem `vendorId`
  são rejeitadas com `403`.
</ParamField>

## Path params

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

## Query params

<Info>O account e o vendor são derivados da sua API key (vendor-scoped) — não são enviados por query.</Info>

<ParamField query="fields" type="string">
  Projeção — veja [Projeção de campos](/pt/api-reference/list-orders#projecao-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">Dia de negócio exato, `YYYY-MM-DD`.</ParamField>
<ParamField query="dateFrom" type="string">Início do intervalo, `YYYY-MM-DD`.</ParamField>
<ParamField query="dateTo" type="string">Fim do intervalo, `YYYY-MM-DD`.</ParamField>
<ParamField query="dateFilterMode" type="string" default="business_day">`business_day` ou `created_at`.</ParamField>
<ParamField query="tzOffset" type="string" default="+00:00">Offset de timezone para o modo `created_at`.</ParamField>
<ParamField query="channel" type="string">Código de canal.</ParamField>
<ParamField query="fulfillmentMethod" type="string">Código de serviço de fulfillment.</ParamField>
<ParamField query="paymentMethod" type="string">Código de método de pagamento.</ParamField>
<ParamField query="orderCode" type="string">Match parcial sobre order code.</ParamField>
<ParamField query="search" type="string">UUID exato, ou external order id / order code parcial.</ParamField>
<ParamField query="page" type="integer" default="1">Número da página (base 1).</ParamField>
<ParamField query="size" type="integer" default="20">Tamanho da página (1–100).</ParamField>

## Requisição

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

## Resposta

Mesmo formato de [Listar pedidos](/pt/api-reference/list-orders): `{ orders, pagination }`.

Para ver como vai a cobrança de cada pedido, projete `settlement` — veja
[Progresso da cobrança](/pt/api-reference/list-orders#progresso-da-cobranca-settlement-e-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 pedidos" icon="receipt" href="/pt/api-reference/list-orders">
    Lista todos os pedidos do seu account e vendor.
  </Card>

  <Card title="Obter loja" icon="store" href="/pt/api-reference/get-store">
    Leia a loja à qual esta listagem pertence.
  </Card>
</CardGroup>