Skip to main content
GET
Retrieve a buyer
Use this endpoint to fetch the current state of a specific buyer record at any time. The response includes all company information stored for the buyer, their current status in the Tilta lifecycle, and any additional identifiers or custom data attached to the record. You can use this endpoint to verify that buyer data is up to date before creating an order or requesting a credit facility.
If the buyer has no credit facility yet, create a onboarding session and direct them to the returned URL to complete their credit application.

Authorizations

Authorization
string
header
required

Your Tilta API key, sent as Bearer <key>.

Path Parameters

external_id
string
required

Unique identifier of a buyer.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$

Query Parameters

expand
enum<string>[] | null

Buyer sub-entities to expand in the response object. Currently supported: contacts (buyer contacts).

Available options:
contacts
Example:

Response

Details of the buyer.

external_id
string
required

Unique identifier of a buyer.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
created_at
number
required

Timestamp indicating when the buyer was created (unix time in seconds).

Example:

1582896122

updated_at
number
required

Timestamp indicating the last time the buyer was updated (unix time in seconds).

Example:

1582896122

max_days_past_due
integer | null
required

Maximum days past due among DUE invoices.

Buyer's full legal name incl. the legal form if applicable.

Example:

"ACME GmbH"

Buyer's legal form which depends on the buyer's registered country. Available legal forms cover Tilta's operating countries.

Available options:
LIMITED_COMPANY,
SOLE_TRADER,
PARTNERSHIP,
PUBLIC_COMPANY,
COOPERATIVE,
GOVERNMENT,
OTHER
business_address
object
required

Buyer's billing address.

trading_name
string | null

Buyer's trading name. If it's not provided, Tilta will use the legal_name.

Example:

"ACME"

registered_at
number | null

Buyer' registration date (unix time in seconds), when they signed up on your platform.

Example:

1582896122

incorporated_at
number | null

Buyer's date of incorporation (unix time in seconds), meaning the date when the business of registered or started.

Example:

1582896122

business_identifiers
object[] | null

A list of business identifiers

delivery_address
object | null

Buyer's default delivery address.

custom_data
object | null

Free-form metadata for storing integration-specific data alongside this buyer. Replaces the existing object entirely on update.

contacts
object[]

Buyer contacts. Returned when expand includes contacts.