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

# Obter loja

> Leia uma loja específica por id. A loja deve pertencer ao account e vendor da sua API key.

Retorna uma loja pelo seu id, com a **configuração completa** — o mesmo formato de cada entrada em
[Listar lojas](/pt/api-reference/list-stores) (location, services, channels, schedules, informações de
impostos e contato, configuração de delivery, metas de vendas, o bloco fiscal e o estado operacional).
Se a loja não existe — ou pertence a outro tenant — a resposta é `404` (a existência nunca é vazada
entre tenants).

## Autenticação

<ParamField header="x-api-key" type="string" required>
  Sua API key do Fire com scope `store: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

<ParamField query="fields" type="string">
  Lista de campos a retornar separados por vírgula (projeção). Veja
  [Projeção de campos](/pt/api-reference/list-stores#projecao-de-campos). Omita para retornar todos os campos.
</ParamField>

## Requisição

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

## Resposta

O objeto loja completo — veja [Listar lojas](/pt/api-reference/list-stores) para a referência completa
de campos e [o bloco fiscal](/pt/api-reference/list-stores#o-bloco-fiscal).

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "storeNumber": 10,
    "storeCode": "ST-10",
    "accountId": "550e8400-e29b-41d4-a716-446655440000",
    "vendorId": "100.1.10",
    "name": "Main Store",
    "externalId": "EXT-10",
    "status": "PUBLISHED",
    "active": "ACTIVE",
    "timezone": "America/Guayaquil",
    "location": {
      "countryId": "1",
      "countryCode": "EC",
      "countryName": "Ecuador",
      "cityId": "2",
      "cityCode": "UIO",
      "cityName": "Quito",
      "address": "Av. Amazonas N32-14",
      "latitude": -0.18,
      "longitude": -78.47,
      "timezone": "America/Guayaquil",
      "currencyCode": "USD"
    },
    "services": [],
    "channels": [
      { "code": "APP", "enabled": true, "fulfillmentTypes": ["DELIVERY", "PICKUP"] }
    ],
    "publishedChannels": ["APP"],
    "operationSchedule": [],
    "salesSchedule": [],
    "schedulesByChannel": [],
    "taxesInfo": { "taxRate": 0, "vatRatePercentage": 12 },
    "contactInfo": { "phone": "+593 2 000 0000" },
    "deliveryInfo": null,
    "salesGoals": null,
    "fiscal": {
      "enabled": true,
      "company": {
        "govIdType": "RUC",
        "govIdNumber": "1790012345001",
        "legalName": "Sandbox Ecuador Cia. Ltda.",
        "tradeName": "Sandbox EC"
      },
      "govIdType": "RUC",
      "govIdNumber": "1790012345001"
    },
    "operational": {
      "isBusinessDayOpen": true,
      "businessDayDate": "2026-07-01",
      "activeChannels": ["APP"]
    },
    "syncStatus": "SYNCED",
    "lastSyncedAt": "2026-07-01T00:00:00Z",
    "createdAt": "2026-06-01T00:00:00Z",
    "updatedAt": "2026-06-02T00:00:00Z"
  }
  ```

  ```json 404 — não existe ou é de outro tenant theme={null}
  {
    "success": false,
    "error": "NOT_FOUND",
    "message": "Store not found with ID 550e8400-e29b-41d4-a716-446655440000"
  }
  ```
</ResponseExample>

## Relacionado

<CardGroup cols={2}>
  <Card title="Listar lojas" icon="store" href="/pt/api-reference/list-stores">
    Lista todas as lojas do seu account e vendor.
  </Card>

  <Card title="Listar pedidos da loja" icon="receipt" href="/pt/api-reference/list-store-orders">
    Lista os pedidos desta loja.
  </Card>
</CardGroup>