Skip to main content
GET
Search businesses
Before onboarding a company as a buyer or merchant, use this endpoint to look them up in Tilta’s business registry. A successful search lets you verify that the business exists, retrieve its official registration details, and pre-fill your onboarding form – reducing manual data entry errors and improving conversion. You can search by business name and country, or by unique identifiers such as a tax ID or commercial registration number. Providing identifiers typically yields more precise results than a name-only search.
Use the data returned by this endpoint to pre-populate the business registration fields in your buyer or merchant onboarding form. This reduces friction for your users and lowers the chance of data-entry errors that could delay underwriting.
An empty items array means no matching businesses were found in Tilta’s registry for the given country. The business may still be onboardable – ask the buyer to enter their details manually. Not all registries are available in all countries.

Authorizations

Authorization
string
header
required

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

Query Parameters

limit
integer
default:10

The number of records to be returned.

Example:

10

search_type
enum<string>
required

Type of search to perform

Available options:
identifier,
name_address
country
string
required

Two-letter country code

Required string length: 2
Example:

"DE"

identifier_type
enum<string>

Type of business identifier (required for identifier search)

Available options:
VAT_ID,
REGISTER_ID
identifier_value
string

Value of business identifier (required for identifier search)

name
string

Business name (required for name_address search)

street
string

Street address (optional for name_address search)

city
string

City (optional for name_address search)

postcode
string

Postal code (optional for name_address search)

Response

items
object[]
required
limit
number
required
total
number
required