Skip to main content
GET
Get a contact
Use this endpoint to fetch the current details of a specific contact by their external identifier. The response includes the contact’s name, email address, phone number, optional address, and the buyer they are associated with. You can use this endpoint to verify stored contact data before an order is placed, confirm email addresses are current, or troubleshoot missing communications for a specific buyer.

Authorizations

Authorization
string
header
required

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

Path Parameters

external_id
string
required

Unique identifier of a contact.

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

Response

Contact response payload.

external_id
string
required

Unique identifier of a contact.

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

External identifier of the buyer this contact belongs to.

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

Whether this contact should automatically be assigned to all invoices created for the buyer.

created_at
number
required

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

Example:

1582896122

updated_at
number
required

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

Example:

1582896122

salutation
enum<string> | null

Contact salutation.

Available options:
MR,
MS,
OTHER
first_name
string | null

Contact first name.

last_name
string | null

Contact last name.

email
string<email> | null

Contact email.

phone
string | null

Contact phone number in E.164 format (e.g. +491711010101).

Example:

"+491711010101"

address
object | null

Contact's address.