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

# List Suppliers

`GET /cleemy-procurement/api/suppliers`

List suppliers.

## Query parameters

- `state` 'Active' | 'Archived'
- `search.terms` string
- `fields.root` 'count'
- `page` integer
- `limit` integer

## Response `200`

OK

- object
  - `items` Supplier[], required
    - `id` integer
    - `name` string
    - `state` 'Active' | 'Archived'
    - `territory` object — **Read-only.** Territory of the supplier.
      - `id` integer
      - `name` string
      - `href` string, uri
    - `territoryId` string — **Write-only.** ID of the territory.
    - `legalRegistration` object
      - `identifier` string, nullable — Legal registration number (e.g. SIRET).
      - `vatNumber` string, nullable — Intra-community VAT number.
    - `contacts` object[]
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `email` string, email, nullable
      - `phone` string, nullable
    - `paymentTerm` object, nullable — Default payment term for this supplier.
      - `value` integer
      - `unit` 'Day' | 'Week' | 'Month' | 'Year' — Day: day. Week: week. Month: month. Year: year.
    - `bankAccount` object, nullable
      - `iban` string, nullable
      - `bic` string, nullable
    - `preferredNature` object, nullable — **Read-only.** Preferred nature for this supplier.
      - `id` integer
      - `name` string
      - `href` string
    - `preferredNatureId` integer, nullable — **Write-only.** ID of the preferred nature.
    - `preferredPaymentMethod` 'BankTransfer' | 'PhysicalCard' | 'Check' | 'DirectDebit' | 'SingleUseCard' — BankTransfer: bank transfer. PhysicalCard: physical card. Check: check. DirectDebit: direct debit. SingleUseCard: single use card.
    - `preferredCostCenter` CostCenterReference — Reference to a cost-center.
      - `id` integer
      - `name` string — **Read-only.** Name of the cost-center.
      - `code` string — **Read-only.** Code of the cost-center.
      - `href` string
    - `preferredCostCenterId` integer, nullable — **Write-only.** ID of the preferred cost-center.
    - `establishments` EstablishmentReference[] — **Read-only.** Establishments associated with this supplier.
      - `id` integer
      - `name` string
      - `href` string, uri
    - `flag` 'Unflagged' | 'Flagged'
  - `prev` union
    - string
    - integer
  - `next` union
    - string
    - integer
  - `count` integer

---

[API](https://skmtc.net/luccasoftware/apis/lucca-expenses.md) · [All operations](https://skmtc.net/luccasoftware/apis/lucca-expenses/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/luccasoftware/lucca-expenses/revisions/110f9897756c/schema)