---
title: "Get Fulfillments Summary"
method: GET
path: "/fulfillments"
tags: ["Fulfillments"]
---

# Get Fulfillments Summary

`GET /fulfillments`

Retrieves a paginated list of fulfillment summary items with optional filtering

## Query parameters

- `outlet_id` string[]
- `sale_id` string[]
- `fulfillment_type` string[]
- `fulfillment_state` string[]
- `page_number` integer
- `page_size` integer

## Response `200`

Successful response with fulfillment summary data

- FulfillmentSummaryResponse
  - `data` FulfillmentSummaryItem[], required
    - `created_at` string, date-time, required — Timestamp when the item was created
    - `id` string, required — Unique identifier for the fulfillment summary item
    - `line_items` FulfillmentSummaryLineItem[], required
      - `fulfilled_quantity` string, required — Quantity that has been fulfilled (decimal as string)
      - `packed_quantity` string, required — Quantity that has been packed (decimal as string)
      - `picked_quantity` string, required — Quantity that has been picked (decimal as string)
      - `product_id` string, required — Identifier of the product
      - `quantity` string, required — Total quantity (decimal as string)
      - `sale_line_item_id` string, required — Identifier of the sale line item
    - `note` string, required — Combined notes with newline separators
    - `outlet_id` string, required — Identifier of the outlet
    - `sale_id` string, required — Identifier of the sale
    - `shipping_address_id` string, nullable — ID of the shipping address associated with this fulfillment. Only present for DISPATCH type fulfillments.
    - `state` 'OPEN' | 'STARTED' | 'PICKED' | 'PACKED' | 'FULFILLED', required — Current state of the fulfillment
    - `type` 'PICKUP' | 'DISPATCH' | 'SERVICE', required — Type of fulfillment
    - `updated_at` string, date-time, required — Timestamp when the item was last updated
    - `user_ids` string[], required — List of user IDs associated with this fulfillment
    - `version` integer, required — Version number for optimistic locking

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden

---

[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)