Skip to main content
GET
Search buyers
The search endpoint matches a single free-text query against your buyers. Use it to verify that a buyer exists before processing an order, or to resolve a buyer when you only have a partial name rather than their identifier.
For filtering on specific attributes – country, legal form, VAT ID, or your own custom data – use List buyers, which accepts a dedicated query parameter per field.

Authorizations

Authorization
string
header
required

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

Query Parameters

limit
integer
default:100

The number of records to be taken.

Required range: x <= 100
Example:

100

offset
integer
default:0

The number of records to be skipped.

Example:

0

query
string
default:""
required
Minimum string length: 1
expand
enum<string>[] | null

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

Available options:
contacts
Example:

Response

Buyers for a platform.

limit
integer
required

The number of taken records.

Required range: x >= 0
Example:

100

offset
integer
required

The number of skipped records.

Required range: x >= 0
Example:

0

total
integer
required

Total number of records

Required range: x >= 0
Example:

140

items
object[]
required