List stores - Fire spark

{
  "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
  }
}

Returns a paginated list of stores a customer can order from. To find stores near the customer, use list stores by coordinates.

Requires a Fire spark access token obtained through token exchange.

Query parameters

Parameter	Type	Default	Description
`brand_id`	string	—	Filter stores by brand. External brand identifier — alphanumeric characters, `_`, and `-` only. 1–64 characters.
`channel_id`	string	—	Only returns stores that have this channel enabled in `channel_ids`.
`fulfillment_id`	string	—	Only returns stores that have this fulfillment enabled in `fulfillment_ids`.
`limit`	integer	`20`	Maximum stores per page. Minimum `1`, maximum `100`.
`cursor`	string	—	Cursor from `pagination.next_cursor` of a previous response. Omit on the first page.

Request the first page with limit=20. Pass pagination.next_cursor as the cursor query parameter until next_cursor is null.

Request

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

Response

The response wraps a page of store objects in data and pagination in pagination. Each store includes contact, location, availability, enabled channels and fulfillments, coverage zones, and CMS template metadata. An empty channel_ids or fulfillment_ids means the store offers none.

{
  "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
  }
}