Skip to main content
GET
Retrieve a supplier
Authentication: API key OAuth 2.0
Scope: supplier_invoice.read
Sensitive fields (payment_details.iban, tax_identifiers) are masked unless the caller holds the permission to see sensitive supplier fields. outstanding_balance is only returned to callers with access to supplier invoice insights.

Authorizations

Authorization
string
header
required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

X-Qonto-Staging-Token
string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Path Parameters

id
string<uuid>
required
Example:

"4d5418bb-bd0d-4df4-865c-c07afab8bb48"

Response

Returns the supplier identified by the id path parameter.

id
string<uuid>
required

Unique identifier of the supplier.

Example:

"018f4e5a-9c1d-7b2e-8a3f-1d2c3b4a5f60"

organization_id
string<uuid>

Identifier of the organization the supplier belongs to.

Example:

"018f4e5a-1111-7b2e-8a3f-1d2c3b4a5f60"

name
string

Name of the supplier.

Example:

"ACME SAS"

status
enum<string>

Lifecycle status of the supplier. It cannot be changed through the create and update endpoints.

Available options:
unarchived,
archived,
draft
Example:

"unarchived"

currency
string

Default currency of the supplier, as an ISO 4217 code.

Example:

"EUR"

default_vat_rate
number

Default VAT rate applied to the supplier's invoices, in percent.

Example:

20

outstanding_balance
object

Outstanding balance of the supplier. Only returned to callers with access to supplier invoice insights.

tax_identifiers
object

Tax identifiers of the supplier. Omitted from responses when empty.

address
object

Postal address of the supplier. Omitted from responses when empty.

contact_info
object

Contact details of the supplier. Omitted from responses when empty.

e_invoicing
object

E-invoicing details of the supplier. Omitted from responses when empty.

payment_details
object

Payment details of the supplier. Omitted from responses when empty.

created_at
string<date-time>

Date and time when the supplier was created.

Example:

"2026-01-15T09:30:00Z"

updated_at
string<date-time>

Date and time when the supplier was last updated.

Example:

"2026-01-16T14:05:00Z"