/suppliers
List suppliers
Returns a paginated list of suppliers for the authenticated tenant. ?modifiedSince= (ISO 8601 UTC datetime) returns records created or changed at or after that instant, and is the intended way to run an incremental sync.
Show the full description
A change anywhere inside the record counts: editing a line moves the parent's modifiedDate too, so no change can hide below the resource level. Deletions are not visible here: a deleted record is really gone, so it simply stops appearing, which is indistinguishable from "unchanged". Poll GET /preview/deletions?deletedSince= alongside this endpoint to learn what was removed. Sorted by supplierNumber ascending.
Query parameters
| Field | Type | Description |
|---|---|---|
search
|
string | Matches supplier number, name, organisation number and city, case-insensitively and on partial words. |
isActive
|
boolean | Filters on whether the supplier is active. |
modifiedSince
|
string(date-time) | Returns only records created or changed at or after this instant (ISO 8601 UTC datetime). A change anywhere inside the record counts, including on its lines. |
page
|
integer | Page to return, 1-based. Default 1. |
pageSize
|
integer | Number of records per page. Default 50, max 200. |
Responses
PagedResult_PublicSupplierResponse
Paginated response: the fields below sit in items[], wrapped in totalCount, page, pageSize, totalPages, hasPreviousPage and hasNextPage. Paginated
| Field | Type | Description |
|---|---|---|
city
|
string · nullable | City name. Null if not set. |
contactPerson
|
string · nullable | Primary contact person at the supplier. Null if not set. |
countryCode
|
string · nullable | ISO 3166-1 alpha-2 country code, e.g. `SE`, `DE`. Null if not set. |
createdDate
|
string(date-time) | UTC timestamp when the supplier record was created. |
currencyCode
|
string · nullable | ISO 4217 currency code purchase orders to this supplier are placed in. |
deliveryTermCode
|
string · nullable | Code of the supplier's default delivery term / Incoterm. Null if not set. |
deliveryTermName
|
string · nullable | Display name of the delivery term. Null if not set. |
id
|
string(uuid) | Internal unique identifier (UUID v7). |
isActive
|
boolean | Whether the supplier is active. Inactive suppliers cannot be used on new purchase orders. |
languageCode
|
string · nullable | ISO 639-1 language code used for purchase order documents, e.g. `sv`, `en`. Null if not set. |
leadTimeDays
|
integer · nullable | Default lead time in calendar days from order to delivery. Null if not set. |
links
|
Links | Hypermedia links for a public API resource. Exposed as a computed `links` property on the public response DTOs so that create and read responses carry the same self-reference — the canonical URL is derived from the business key already present on the DTO and can never drift from the route it points at. |
modifiedDate
|
string(date-time) · nullable | UTC timestamp of the last modification. Null if never modified after creation. |
name
|
string · nullable | Full company name. |
notes
|
string · nullable | Free-text internal notes (not visible to the supplier). Null if not set. |
organizationNumber
|
string · nullable | Company registration number / org.nr. Null if not set. |
ourCustomerNumber
|
string · nullable | Our customer number at the supplier — quoted on purchase orders. Null if not set. |
paymentTermCode
|
string · nullable | Code of the supplier's default payment term — usable as `paymentTermCode`. Null if not set. |
paymentTermName
|
string · nullable | Display name of the payment term. Null if not set. |
phone
|
string · nullable | Primary phone number. Null if not set. |
postalCode
|
string · nullable | Postal / ZIP code. Null if not set. |
purchaseOrderEmail
|
string · nullable | Email address purchase orders are sent to. Null if not set. |
street1
|
string · nullable | Street address line 1. Null if not set. |
street2
|
string · nullable | Street address line 2 (suite, c/o, etc.). Null if not set. |
supplierNumber
|
string · nullable | Unique supplier number — business key used in all URL references. |
website
|
string · nullable | Supplier website URL. Null if not set. |
Standard errors:
401
403
Errors
Examples
curl "https://api.erp.fluit.cloud/preview/suppliers" \
-H "X-Api-Key: fluit_live_sk_..."
{
"hasNextPage": true,
"hasPreviousPage": true,
"items": [
{
"city": "Stockholm",
"contactPerson": "string",
"countryCode": "SE",
"createdDate": "2026-06-11T09:24:13.418",
"currencyCode": "SEK",
"deliveryTermCode": "STD",
"deliveryTermName": "DAP Stockholm",
"id": "0f8b2c1e-4d3a-4b7e-9f10-2a6c5d8e1b44",
"isActive": true,
"languageCode": "STD",
"leadTimeDays": 42,
"links": {
"self": "string"
},
"modifiedDate": "2026-06-11T09:24:13.418",
"name": "Nordic Components AB",
"notes": "string",
"organizationNumber": "ABC-001",
"ourCustomerNumber": "ABC-001",
"paymentTermCode": "STD",
"paymentTermName": "30 days net",
"phone": "+46 8 123 45 67",
"postalCode": "11122",
"purchaseOrderEmail": "order@acme.se",
"street1": "Storgatan 1",
"street2": "string",
"supplierNumber": "SUP-001",
"website": "string"
}
],
"page": 1,
"pageSize": 50,
"totalCount": 137,
"totalPages": 3
}
Base URL https://api.erp.fluit.cloud/preview. The response example is generated from the schema: the shape is right, the values are made up.