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

> Retrieve a single fulfillment mode by its external identifier.

Returns one fulfillment option by external `id`. Use this endpoint after the customer selects a fulfillment mode to load its name, type code, and status for the storefront.

<Note>
  Requires a Fire spark access token obtained through [token
  exchange](/docs/storefront-api/oauth/exchange/post).
</Note>

## Path parameters

| Parameter | Required | Description                                                                                   |
| --------- | -------- | --------------------------------------------------------------------------------------------- |
| `id`      | Yes      | External fulfillment identifier. Alphanumeric characters, `_`, and `-` only. 1–64 characters. |

## Request

```bash theme={null}
curl "https://firespark.cloud/api/storefront/v1/fulfillment/delivery" \
  -H "Authorization: Bearer ACCESS_TOKEN"
```

## Response

The response wraps a single fulfillment object in `data`. The shape matches [list fulfillment options](/docs/storefront-api/fulfillment/get).

<ResponseExample>
  ```json Success theme={null}
  {
    "data": {
      "id": "delivery",
      "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "brand_id": null,
      "organization_id": "11111111-1111-1111-1111-111111111111",
      "merchant_id": "22222222-2222-2222-2222-222222222222",
      "name": "Delivery",
      "type": "DELIVERY",
      "status": "ACTIVE"
    }
  }
  ```
</ResponseExample>

## Fulfillment fields

See [list fulfillment options](/docs/storefront-api/fulfillment/get) for the full schema.

<Tip>
  Use the fulfillment `type` when loading [stores](/docs/storefront-api/stores/get) and
  checking which locations expose that mode. Store responses nest operational
  rules under `fulfillment.<type>`.
</Tip>

## Error responses

| Status | Description                                            |
| ------ | ------------------------------------------------------ |
| `401`  | Missing or invalid access token.                       |
| `403`  | Token does not have access to this fulfillment option. |
| `404`  | No fulfillment option found with the given `id`.       |


## OpenAPI

````yaml storefront-api/openapi.json GET /fulfillment/{id}
openapi: 3.0.1
info:
  title: Fire spark Storefront API
  description: Customer-facing channel endpoints for Fire spark.
  version: 1.0.0
servers:
  - url: https://firespark.cloud/api/storefront/v1
security:
  - bearerAuth: []
paths:
  /fulfillment/{id}:
    get:
      summary: Get fulfillment option
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 64
            pattern: ^[a-zA-Z0-9_-]+$
          description: External fulfillment identifier.
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Fulfillment'
components:
  schemas:
    Fulfillment:
      type: object
      properties:
        id:
          type: string
          minLength: 1
          maxLength: 64
          pattern: ^[a-zA-Z0-9_-]+$
        uid:
          type: string
          format: uuid
        name:
          $ref: '#/components/schemas/MultiLanguageText'
        type:
          type: string
        status:
          type: string
          enum:
            - ACTIVE
            - INACTIVE
    MultiLanguageText:
      type: object
      additionalProperties:
        type: string
      example:
        en_us: Example
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````