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

# Get store

> Read one store configuration by external id.

Returns a single store for the authenticated merchant. Use this endpoint when you already know the external `id` and need the current configuration without listing or paginating all stores.

<Note>
  Requires an access token with the `stores:read` scope. See
  [Token](/docs/integrations-api/oauth/token/post) to obtain a token.
</Note>

## Request

Replace `{id}` with the external store identifier.

```bash theme={null}
curl "https://firespark.cloud/api/integrations/v1/stores/pos-location-01" \
  -H "Authorization: Bearer ACCESS_TOKEN"
```

## Response

The response wraps one store object in `data`. The shape matches [List stores](/docs/integrations-api/stores/get).

<ResponseExample>
  ```json Success theme={null}
  {
    "data": {
      "id": "pos-location-01",
      "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "organization_id": "f1e2d3c4-b5a6-7890-fedc-ba0987654321",
      "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"
      },
      "channels": {},
      "payments": {
        "orderable": true,
        "methods": []
      },
      "cms_template_id": null,
      "cms": null,
      "overrides": []
    }
  }
  ```
</ResponseExample>

## Path parameters

| Parameter | Type   | Description                                                                                                  |
| --------- | ------ | ------------------------------------------------------------------------------------------------------------ |
| `id`      | string | External store identifier. Alphanumeric characters, `_`, and `-` only. 1–64 characters. Unique per merchant. |

## Store object

See the [List stores](/docs/integrations-api/stores/get) reference for the full schema, including `contact`, `location`, `channels`, `payments`, `cms_template_id`, `cms`, and `overrides`.

## Error responses

| Status | Description                                     |
| ------ | ----------------------------------------------- |
| `401`  | Missing or invalid access token.                |
| `403`  | Token does not include the `stores:read` scope. |
| `404`  | No store exists with the given `id`.            |


## OpenAPI

````yaml integrations-api/openapi.json GET /stores/{id}
openapi: 3.0.1
info:
  title: Fire spark Integrations API
  description: POS and RMS integration endpoints for Fire spark.
  version: 1.0.0
servers:
  - url: https://firespark.cloud/api/integrations/v1
security:
  - bearerAuth: []
paths:
  /stores/{id}:
    get:
      summary: Get store
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 64
            pattern: ^[a-zA-Z0-9_-]+$
          description: External store identifier.
        - in: query
          name: brand_id
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 64
            pattern: ^[a-zA-Z0-9_-]+$
          description: >-
            Filter by brand. When set, returns 404 if the store does not belong
            to this brand.
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/StoreUpsert'
components:
  schemas:
    StoreUpsert:
      type: object
      required:
        - id
        - name
        - status
        - timezone
        - contact
        - location
      properties:
        id:
          type: string
          minLength: 1
          maxLength: 64
          pattern: ^[a-zA-Z0-9_-]+$
        brand_id:
          type: string
          minLength: 1
          maxLength: 64
          pattern: ^[a-zA-Z0-9_-]+$
        name:
          type: string
        status:
          type: string
          enum:
            - ACTIVE
            - INACTIVE
        timezone:
          type: string
        contact:
          type: object
        location:
          type: object
        channels:
          type: object
          additionalProperties: true
        payments:
          type: object
        cms_template_id:
          type: string
          format: uuid
          nullable: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````