Skip to main content
GET
Retrieve a merchant
Use this endpoint to fetch the current state of a merchant record at any point in their lifecycle – from initial creation through onboarding completion and ongoing operations. The response includes the merchant’s identity data, registered address, business identifiers, and current onboarding status. This is especially useful for polling approval status after a merchant completes onboarding, or for verifying stored data before submitting an order for financing.
Use the status field to determine whether a merchant is ready to process financed orders. Only merchants with a status of ENROLLED can have their orders financed through Tilta.

Authorizations

Authorization
string
header
required

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

Path Parameters

external_id
string
required

Unique identifier of a merchant.

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

Response

Details for the merchant.

external_id
string
required

Unique identifier of a merchant.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
status
enum<string>
required

Merchant's enrollment status

Available options:
ENROLLED,
INACTIVE,
EXPIRED
created_at
number
required

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

Example:

1582896122

updated_at
number
required

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

Example:

1582896122

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

Example:

"ACME Distribution GmbH"

Merchant's legal form, which depends on the merchant'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

Merchant's address.

contact_emails
string<email>[]
required

Merchant's contact emails

Maximum array length: 10
trading_name
string | null

Merchant's trading name.

Example:

"ACME"

business_identifiers
object[] | null

A list of business identifiers

incorporated_at
number | null

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

Example:

1582896122