This endpoint returns a list of suppliers.

Log in to see full request history
Query Params
integer

suppliers are paginated, this is the current page returned.

Responses

Response body
object
integer
required
integer
required
integer
required
suppliers
array of objects
required
suppliers*
object
string

Company name (present only when type is company)

string | null

Supplier identification number (SIRET).

  • 14-digit number combining SIREN (9 digits) and NIC (5 digits)
  • Only applicable for French companies
string

Supplier's VAT number

plan_item
object
date-time

The last time the supplier has been updated

string

supplier identifier (is unique)

emails
array of strings
emails
string

The IBAN of the supplier.

string | null
deprecated

This field is deprecated. Please use "iban" instead.

string

supplier address (billing address)

string

Postal code (billing address)

string

City (billing address)

string

Country alpha code (billing address)

string

supplier payment conditions

upon_receipt custom 15_days 30_days 45_days 60_days

string

supplier phone number

string

This reference doesn't appear on the invoice

string

Notes about the supplier

string

Recipient displayed in the invoice

billing_address
object
integer

The corresponding identifier for this resource in the V2 API.
This field is provided to facilitate migration from V1 to V2 API by allowing mapping
between V1 and V2 identifiers. When transitioning to V2 endpoints, use this value
instead of the V1 id or source_id.

Language
Credentials
OAuth2