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

> Lista ubicaciones del comercio disponibles para pedir en tu canal.

Devuelve una lista paginada de tiendas desde las que un cliente puede pedir. Para buscar por coordenadas, usa [listar tiendas cercanas](https://firespark.cloud/docs/es/storefront-api/stores/nearby/get.md).

> [!NOTE]
>
> Requiere un access token de Fire spark obtenido con [intercambio de
> token](https://firespark.cloud/docs/es/storefront-api/oauth/exchange/post.md).

## Parámetros de query

| Parámetro | Tipo | Default | Descripción |
| - | - | - | - |
| `brand_id` | string | — | Filtra por marca. Identificador externo — alfanumérico, `_` y `-`. 1–64 caracteres. |
| `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`. Omítelo en la primera página. |

> [!TIP]
>
> Pide la primera página con `limit=20`. Pasa `pagination.next_cursor` como
> `cursor` hasta que `next_cursor` sea `null`.

## Solicitud

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

## 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. Un `channel_ids` o `fulfillment_ids` vacío significa que la tienda no ofrece ninguno.

```json Success theme={null}
{
  "data": [
    {
      "id": "downtown-kitchen",
      "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "merchant_id": "22222222-2222-2222-2222-222222222222",
      "brand_id": "0001",
      "name": "Downtown Kitchen",
      "status": "ACTIVE",
      "timezone": "America/Guayaquil",
      "contact": {
        "email": "downtown@merchant.com",
        "phone": "+593991234567",
        "name": "Downtown Kitchen"
      },
      "location": {
        "latitude": -2.1894,
        "longitude": -79.8891,
        "address_line_1": "Av. 9 de Octubre 123",
        "city": "Guayaquil",
        "country": "Ecuador",
        "postal_code": "090101",
        "business_name": "Downtown Kitchen S.A."
      },
      "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.