---
title: "Query Suppliers"
method: GET
path: "/v2/suppliers"
tags: ["supplier"]
---

# Query Suppliers

`GET /v2/suppliers`

Query all suppliers

## Query parameters

- `lastChangedSince` string, date-time
- `lastChangedUntil` string, date-time
- `pageNumber` integer
- `pageSize` integer

## Headers

- `x-tenant-id` string, uuid, required
- `x-runas` string
- `x-companyid` string

## Response `200`

Returns all suppliers.

- JTLWawiRestContractsModelsPagedListOfJTLWawiRestContractsModelsV1SupplierSupplier — Represents a paginated list of items
  - `totalItems` integer — Gets or sets the total number of items available in the data source.
  - `pageNumber` integer — Gets or sets the current page number in the paginated list.
  - `pageSize` integer — Gets or sets the number of items per page in the paginated list.
  - `items` JTLWawiRestContractsModelsV1SupplierSupplier[] — Gets or sets the collection of items contained in the paged list.
    - `id` string, uuid
    - `name` string — Supplier name.
    - `type` string
    - `supplierNo` string — Supplier ID number.
    - `internalCustomerId` string — Internal customer ID of the supplier.
    - `languageISO` string — The language ISO of a supplier.
    - `formOfAddress` string — The form of address of the supplier.
    - `firstName` string — Supplier first name.
    - `lastName` string — Supplier last name.
    - `company` string — Name of the supplier's company.
    - `company2` string — The additional address infomation about the company.
    - `contact` string — Supplier's contact person.
    - `street` string — Supplier's street and house number.
    - `address2` string — Additional address information.
    - `postalCode` string — Supplier's postal code.
    - `city` string — Supplier's city.
    - `state` string — Supplier's state.
    - `countryIso` string — Country ISO code of the address.
    - `phone` string — Supplier's main telephone number.
    - `phoneExtension` string — Supplier's telephone number extension.
    - `fax` string — Supplier's fax number.
    - `email` string — Supplier's email address.
    - `website` string — Supplier's website.
    - `comment` string — Additional information about the supplier.
    - `vatID` string — Supplier's VAT ID number.
    - `status` string — Supplier's status.
    - `lastChangedDate` string, date-time — Last change date of the supplier.
  - `totalPages` integer — Gets the total number of pages based on the total number of items and the page size.
  - `hasPreviousPage` boolean — Gets a value indicating whether there is a previous page available in the paginated list.
  - `hasNextPage` boolean — Gets a value indicating whether there is a next page available.
  - `nextPageNumber` integer — Gets the number of the next page if there is one; otherwise, returns the total number of pages.
  - `previousPageNumber` integer — Gets the number of the previous page. If there is no previous page, it returns 1.

## Other responses

- `401`
- `402` — No licence available or the app has not been authorised by JTL.
- `404` — No fields could be found.

---

[API](https://skmtc.net/jtl-software/apis/scx-authentication-api.md) · [All operations](https://skmtc.net/jtl-software/apis/scx-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jtl-software/scx-authentication-api/revisions/f979b1ea6951/schema)