---
title: "List serial numbers"
method: GET
path: "/serialnumbers"
tags: ["Serial Numbers"]
---

# List serial numbers

`GET /serialnumbers`

Returns a paginated list of serial numbers.

🔒 Requires: `serial_numbers:read` scope

## Query parameters

- `product_id` string, uuid
- `outlet_id` string, uuid
- `sale_id` string, uuid
- `line_item_id` string, uuid
- `after` integer
- `before` integer
- `page_size` integer

## Response `200`

A paginated list of serial numbers.

- SerialNumberCollection
  - `data` SerialNumber[] — An array of Serial Numbers wrapped in top level `data` object.
    - `code` string — The actual serial number value.
    - `id` string — Auto-generated object ID.
    - `line_item_id` string, uuid, nullable — The ID of the sale line item where this serial number was sold, or null.
    - `outlet_id` string, uuid — The ID of the outlet where the serial number is located.
    - `product_id` string, uuid — The ID of the product associated with the serial number.
    - `sale_id` string, uuid, nullable — The ID of the sale where this serial number was sold, or null.
    - `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/versions/72d4ceb46dbb/schema)