---
title: "Get consignment totals"
method: GET
path: "/consignments/{consignment_id}/totals"
tags: ["Consignments"]
---

# Get consignment totals

`GET /consignments/{consignment_id}/totals`

Returns the count and cost for the given consignment.

The consignment type can be `SUPPLIER`, `OUTLET` or `RETURN` (not `STOCKTAKE`).

The status of the consignment will determine which values make sense:

- If the consignment type is `OUTLET` the sent cost may not be accurate when the status is `OPEN`.
- If the consignment is `OPEN` or `SENT` the received count and cost should both be zero.
- For completely received consignments received cost should equal the sent cost and the received count should equal the sent count.
- For partially received consignments we would expect the received cost value to be less than sent cost value, and the received count to be less than the sent count.

🔒 Requires: `consignments:read` scope

## Path parameters

- `consignment_id` string, uuid, required

## Response `200`

OK

- ConsignmentTotalsResponse
  - `data` object[]
    - `total_received_cost` string
    - `total_received_count` string
    - `total_sent_cost` string
    - `total_sent_count` string

---

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