---
title: "List consignments"
method: GET
path: "/consignments"
tags: ["Consignments"]
---

# List consignments

`GET /consignments`

Return a paginated list of consignments.

🔒 Requires: `consignments:read` scope

## Query parameters

- `type` 'SUPPLIER' | 'OUTLET' | 'STOCKTAKE' | 'RETURN', string
- `status` 'OPEN' | 'SENT' | 'DISPATCHED' | 'RECEIVED' | 'STOCKTAKE_IN_PROGRESS' | 'STOCKTAKE_SCHEDULED' | 'STOCKTAKE_IN_PROGRESS_PROCESSED' | 'STOCKTAKE_COMPLETE' | 'CLOSED' | 'CANCELLED', string
- `outlet_id` string, uuid
- `after` integer
- `before` integer
- `page_size` integer

## Response `200`

OK

- ConsignmentCollection
  - `data` Consignment[] — An array of Consignment objects.
    - `consignment_date` string, nullable — 11-28T19:02:15+00:00 (timestamp) - Consignment creation date.
    - `created_at` string, nullable — Creation timestamp in UTC.
    - `deleted_at` string, nullable — Deletion timestamp in UTC.
    - `due_at` string, nullable — 11-30T19:08:541+00:00 (timestamp) - Due date.
    - `id` string, uuid — Auto-generated object ID.
    - `name` string, required — Tue 29 Nov 2016 (string) - Consignment name. For orders, the note field in the UI will be the name value.
    - `outlet_id` string, uuid, required — A valid ID of an outlet where stock will be received.
    - `received_at` string, nullable — 11-30T19:08:541+00:00 (timestamp) - The date when consignment was received.
    - `reference` string, nullable — Order number.+ `total_count_gain` (number)
    - `source_outlet_id` string, uuid, nullable — A valid ID of an outlet where stock will come from. **Stock transfers only**.
    - `status` 'OPEN' | 'SENT' | 'DISPATCHED' | 'RECEIVED' | 'STOCKTAKE_IN_PROGRESS' | 'STOCKTAKE_SCHEDULED' | 'STOCKTAKE_IN_PROGRESS_PROCESSED' | 'STOCKTAKE_COMPLETE' | 'CLOSED' | 'CANCELLED' — * Supplier Order: One of `OPEN`, `SENT`, `DISPATCHED`, `RECEIVED`, `CANCELLED` * Outlet Transfer: One of `OPEN`, `SENT`, `RECEIVED`, `CANCELLED` * Return Order: One of `OPEN`, `SENT`, `CANCELLED` * Stocktake: One of `STOCKTAKE_SCHEDULED`, `STOCKTAKE_IN_PROGRESS`, `STOCKTAKE_IN_PROGRESS_PROCESSED`, `STOCKTAKE_COMPLETE`, `CLOSED`, `CANCELLED` This is not a definitive list and may be extended in future
    - `supplier_id` string, uuid, nullable — a valid supplier ID.
    - `supplier_invoice` string, nullable — Supplier invoice number.
    - `total_cost_gain` number, double, nullable — The cost of items over the expected level.
    - `total_cost_loss` number, double, nullable — The cost of items below the expected level.
    - `total_count_gain` number, double, nullable — The number of items over the expected level.
    - `total_count_loss` number, double, nullable — The number of items below the expected level.
    - `type` 'SUPPLIER' | 'OUTLET' | 'STOCKTAKE' | 'RETURN', required — One of `SUPPLIER`, `OUTLET`, `STOCKTAKE`, `RETURN`.
    - `updated_at` string — Last update timestamp in UTC.
    - `version` integer — Auto-incrementing object version number.
  - `version` Version — An object containing the highest and lowest version numbers for all items of the returned collection.
    - `max` integer, nullable, required — Highest version number of the payload, or `null` when the result set is empty.
    - `min` integer, nullable, required — Lowest version number of the payload, or `null` when the result set is empty.

---

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