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

# Listar tiendas

> Lee la configuración de tiendas para mapear ubicaciones de POS y RMS.

Devuelve las tiendas del comercio autenticado. Úsalo para mapear tiendas de Fire spark a ubicaciones de POS o RMS antes de sincronizar menús.

> [!NOTE]
>
> Requiere un access token con el scope `stores:read`. Ver
> [Token](https://firespark.cloud/docs/es/integrations-api/oauth/token/post.md) para obtenerlo.

## Solicitud

```bash theme={null}
curl "https://firespark.cloud/api/integrations/v1/stores?brand_id=0001&limit=20" \
  -H "Authorization: Bearer ACCESS_TOKEN"
```

## Parámetros de query

| Parámetro | Tipo | Default | Descripción |
| - | - | - | - |
| `brand_id` | string | — | Filtra por marca. Identificador externo — alfanumérico, `_` y `-`. 1–64 caracteres. Si se omite, se devuelven todas las tiendas del comercio. |
| `channel_id` | string | — | Solo devuelve tiendas que tengan este canal activo en `channel_ids`. |
| `fulfillment_id` | string | — | Solo devuelve tiendas que tengan este fulfillment activo en `fulfillment_ids`. |
| `limit` | integer | `20` | Máximo de tiendas por página. Mínimo `1`, máximo `100`. |
| `cursor` | string | — | Cursor de `pagination.next_cursor` de una respuesta anterior. Omítelo en la primera página. |

## Respuesta

La respuesta envuelve una página de tiendas en `data` y paginación en `pagination`. Cada tienda incluye contacto, ubicación, disponibilidad, canales y fulfillments activos, zonas de cobertura y metadatos de plantilla CMS.

```json Success theme={null}
{
  "data": [
    {
      "id": "pos-location-01",
      "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "merchant_id": "c1d2e3f4-a5b6-7890-cdef-123456789abc",
      "brand_id": "0001",
      "name": "Main Street",
      "status": "ACTIVE",
      "timezone": "America/Guayaquil",
      "contact": {
        "email": "main@merchant.com",
        "phone": "+593991234567",
        "name": "Main Street"
      },
      "location": {
        "latitude": -2.1894,
        "longitude": -79.8891,
        "address_line_1": "Calle Principal 456",
        "city": "Guayaquil",
        "country": "Ecuador",
        "postal_code": "090101",
        "business_name": "Main Street Restaurant"
      },
      "instructions": null,
      "coverage_zones": [],
      "availability": {
        "schedules": null,
        "temporary_closed_reason": null,
        "temporary_closed_until": null,
        "status": "OPEN"
      },
      "channel_ids": ["web", "app"],
      "fulfillment_ids": ["delivery", "pickup"],
      "labels": [],
      "tags": {},
      "cms_template_id": null,
      "cms": null
    }
  ],
  "pagination": {
    "next_cursor": null,
    "prev_cursor": null
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.