Get suppliers filtered and paged

paging.pageSize

integer, 1 to 1000, nullable

Optional

The number of suppliers to return per page. Defaults to 100 when not given.

paging.pageNumber

integer, 1 to 9999, nullable

Optional

The page number to retrieve. Defaults to 1 when not given.

sorting.columnName

string, nullable

Optional

The name of the field to sort the results by.

sorting.order

integer (enum), nullable

Optional

The sort direction. Allowed values: 0 = Ascending, 1 = Descending.

filter.name

string, nullable

Optional

Filters on the supplier's name.

filter.reference

string, nullable

Optional

Filters on the supplier's internal identifier (Reference/Code).

filter.externalIdentifier

string, nullable

Optional

Filters on the supplier's external API identifier.

filter.supplierTypeName

string, nullable

Optional

Filters on the supplier type assigned to the supplier.

filter.phoneNumber

string, nullable

Optional

Filters on the supplier's landline phone number.

filter.mobileNumber

string, nullable

Optional

Filters on the supplier's mobile phone number.

filter.primaryEmailAddresses

string, nullable

Optional

Filters on the supplier's primary email address(es).

filter.addressStreetAndHouseNumber

string, nullable

Optional

Filters on the combined street and house number of the supplier's address.

filter.addressPostalCode

string, nullable

Optional

Filters on the postal code of the supplier's address.

filter.addressCity

string, nullable

Optional

Filters on the city of the supplier's address.

filter.addressCountryISOCode

string, nullable

Optional

Filters on the ISO 3166-1 alpha-2 country code of the supplier's address.

filter.archiveDate.from

string (date-time), nullable

Optional

Inclusive lower bound for filtering on archive date, formatted as ISO 8601 (for example "2026-01-01T00:00:00Z"). If omitted, there is no lower bound.

filter.archiveDate.to

string (date-time), nullable

Optional

Inclusive upper bound for filtering on archive date, formatted as ISO 8601. If omitted, there is no upper bound.

filter.lastModified.from

string (date-time), nullable

Optional

Inclusive lower bound for filtering on the date the record was last modified, formatted as ISO 8601. If omitted, there is no lower bound.

filter.lastModified.to

string (date-time), nullable

Optional

Inclusive upper bound for filtering on the date the record was last modified, formatted as ISO 8601. If omitted, there is no upper bound.

paging.pageSize

integer, 1 to 1000, nullable

Optional

The page size used to produce this result set.

paging.pageNumber

integer, 1 to 9999, nullable

Optional

The page number returned in this result set.

sorting.columnName

string, nullable

Optional

The field the results are sorted by.

sorting.order

integer (enum), nullable

Optional

The sort direction applied. Allowed values: 0 = Ascending, 1 = Descending.

suppliers

array of objects, nullable

Optional

The list of suppliers matching the filter for this page. See sub-fields below.

suppliers.name

string, nullable

Optional

The supplier's registered or trading name.

suppliers.reference

string, nullable

Optional

The internal identifier (Reference/Code) of the supplier.

suppliers.externalIdentifier

string, nullable

Optional

The external API identifier of the supplier, if any.

suppliers.supplierTypeName

string, nullable

Optional

The supplier type assigned to the supplier.

suppliers.phoneNumber

string, nullable

Optional

The supplier's landline phone number.

suppliers.mobileNumber

string, nullable

Optional

The supplier's mobile phone number.

suppliers.primaryEmailAddresses

string, nullable

Optional

The supplier's primary email address(es). Formatted as a single semicolon-separated string, consistent with the pattern confirmed for the Person search result.

suppliers.addressStreetAndHouseNumber

string, nullable

Optional

The combined street and house number of the supplier's address, for example "Bredaseweg 12".

suppliers.addressPostalCode

string, nullable

Optional

The postal code of the supplier's address.

suppliers.addressCity

string, nullable

Optional

The city of the supplier's address.

suppliers.addressCountryISOCode

string, nullable

Optional

The ISO 3166-1 alpha-2 country code of the supplier's address.

suppliers.archiveDate

string (date-time), nullable

Optional

The date and time from which the supplier is archived, formatted as ISO 8601. Null if not archived.

suppliers.lastModified

string (date-time), nullable

Optional

The date and time the record was last modified, formatted as ISO 8601.