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

> Read one fulfillment type definition by external id.

Returns a single fulfillment option for the authenticated merchant. Use this endpoint when you already know the external `id` and need the current name, type code, and status without listing all options.

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

## Request

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

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

## Response

The response wraps one fulfillment object in `data`.

<ResponseExample>
  ```json Success theme={null}
  {
    "data": {
      "id": "delivery",
      "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "organization_id": "f1e2d3c4-b5a6-7890-fedc-ba0987654321",
      "merchant_id": "c1d2e3f4-a5b6-7890-cdef-123456789abc",
      "name": "Delivery",
      "type": "DELIVERY",
      "status": "ACTIVE"
    }
  }
  ```
</ResponseExample>

## Path parameters

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

## Fulfillment object

| Field             | Type          | Description                                                                                                          |
| ----------------- | ------------- | -------------------------------------------------------------------------------------------------------------------- |
| `id`              | string        | External fulfillment identifier. Matches the path parameter.                                                         |
| `uid`             | string (UUID) | Fire spark internal identifier.                                                                                      |
| `organization_id` | string (UUID) | Organization that owns the merchant.                                                                                 |
| `merchant_id`     | string (UUID) | Merchant the fulfillment option belongs to.                                                                          |
| `name`            | string        | Display name. 1–100 characters.                                                                                      |
| `type`            | string        | Fulfillment type code. 1–100 characters. Common values: `DELIVERY`, `PICKUP`, `DINE_IN`. Custom codes are supported. |
| `status`          | string        | `ACTIVE` or `INACTIVE`.                                                                                              |

## Error responses

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


## OpenAPI

````yaml integrations-api/openapi.json GET /fulfillment/{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:
  /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/FulfillmentUpsert'
components:
  schemas:
    FulfillmentUpsert:
      type: object
      required:
        - id
        - name
        - type
        - status
      properties:
        id:
          type: string
          minLength: 1
          maxLength: 64
          pattern: ^[a-zA-Z0-9_-]+$
        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

````