---
title: "Fulfill line items within a sale"
method: POST
path: "/fulfillments/{fulfillment_id}/fulfill"
tags: ["Fulfillments"]
---

# Fulfill line items within a sale

`POST /fulfillments/{fulfillment_id}/fulfill`

Fulfills line items for a given sale. This is an idempotent action.

Each line item may optionally include a `source_breakdown`, which specifies how a fulfillment quantity should be sourced.
When provided, all three fields are required and must sum to the parent quantity.

🔒 Requires: `sales:write` scope

## Path parameters

- `fulfillment_id` string, required

## Request body

- FulfillLineItemsRequest
  - `line_items` FulfillmentLineItemRequest[], required — The line items to be fulfilled
    - `quantity` number, double, required — The quantity to be fulfilled
    - `sale_line_item_id` string, uuid, required — The unique identifier of the sale line item to be fulfilled.
    - `source_breakdown` FulfillLineItemSourceBreakdown — Specifies how a fulfillment quantity should be sourced. When provided, all three fields are required and must sum to the parent quantity.
      - `quantity_from_not_started` number, double, required — Quantity to source from the not-started state.
      - `quantity_from_packed` number, double, required — Quantity to source from the packed state.
      - `quantity_from_picked` number, double, required — Quantity to source from the picked state.
  - `version` integer, required — The current version number of the fulfillment.

## Response `200`

Sale line item fulfilled successfully.

- FulfillLineItemsResponse
  - `data` object
    - `id` string — The unique identifier of the fulfillment.
    - `version` integer — The new version number of the fulfillment after the update.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `409` — Conflict

---

[API](https://skmtc.net/lightspeedhq/apis/api-2026-07.md) · [All operations](https://skmtc.net/lightspeedhq/apis/api-2026-07/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightspeedhq/api-2026-07/revisions/72d4ceb46dbb/schema)