---
title: "List suppliers"
method: GET
path: "/suppliers"
tags: ["Suppliers"]
---

# List suppliers

`GET /suppliers`

Returns a paginated list of suppliers.

🔒 Requires: `suppliers:read` scope

## Query parameters

- `after` integer
- `before` integer
- `page_size` integer
- `deleted` boolean

## Response `200`

- SupplierCollection
  - `data` Supplier[], required — An array of Suppliers wrapped in top level `data` object.
    - `contact` object, nullable, required — Contact information for the supplier.
      - `company_name` string, nullable — The name of the supplier company. This field is defaulted to the supplier name if not provided.
      - `email` string, nullable — The contact email of the supplier.
      - `fax` string, nullable — Fax number of the supplier.
      - `first_name` string, nullable — The firstname of the contact person.
      - `last_name` string, nullable — The last name of the contact person.
      - `mobile` string, nullable — Mobile contact number of the supplier.
      - `phone` string, nullable — Physical contact number of the supplier.
      - `physical_address1` string, nullable — Line 1 address of the supplier's physical address.
      - `physical_address2` string, nullable — Line 2 address of the supplier's physical address.
      - `physical_city` string, nullable — City of the supplier's physical address.
      - `physical_country_id` string, nullable — ID of the country of the supplier's physical address.
      - `physical_postcode` string, nullable — Postcode of the supplier's physical address.
      - `physical_state` string, nullable — State of the supplier's physical address.
      - `physical_suburb` string, nullable — Suburb of the supplier's physical address.
      - `postal_address1` string, nullable — Line 1 address of the supplier's postal address.
      - `postal_address2` string, nullable — Line 2 address of the supplier's postal address.
      - `postal_city` string, nullable — City of the supplier's postal address.
      - `postal_country_id` string, nullable — ID of the country of the supplier's postal address.
      - `postal_postcode` string, nullable — Postcode of the supplier's postal address.
      - `postal_state` string, nullable — State of the supplier's postal address.
      - `postal_suburb` string, nullable — Suburb of the supplier's postal address.
      - `twitter` string, nullable — Twitter handle of the supplier contact.
      - `website` string, nullable — The website address of the supplier
    - `default_markup` number — This is used for record-keeping purposes and it does not have any effect on your products.
    - `description` string, nullable — The Supplier description.
    - `name` string, required — The Supplier name.
  - `version` Version, required — 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)