Bulk-fetch contacts by ID

POST

/contacts/get-many

• Production

Fetch up to 50 contacts by ID in a single round-trip. Returns rows for IDs that exist in the tenant — IDs that don’t exist (or belong to another tenant) are silently omitted. Compare meta.requested to meta.returned to detect missing.

Authorizations

• bearerAuth
  contacts:read

Request Body

object

ids

required

Array<integer>

>= 1 items <= 50 items

Responses

200

Contacts

object

data

required

Array<object>

object

id

required

integer

firstName

required

string | null

lastName

required

string | null

companyName

required

string | null

email

required

string | null format: email

phone

required

string | null

type

required

string

createdAt

required

Any of:

string

string format: date-time

string

string

updatedAt

required

Any of:

string

string format: date-time

string

string

meta

required

object

request_id

Server-generated request identifier

string

pagination

object

cursor

required

Opaque cursor for the next page; null when no more results

string | null

has_more

required

Whether more pages are available after this one

boolean

count

required

Items in this page

integer

requested

required

integer

returned

required

integer

403

Scope insufficient

object

type

required

URL identifying the problem type

string format: uri

title

required

Short human-readable summary

string

status

required

HTTP status code

integer

detail

Human-readable explanation

string

request_id

Server-generated request identifier

string

errors

Validation error array (422 only)

Array<object>

object

field

required

Field path that failed validation

string

code

required

Validation error code

string

message

required

Human-readable validation message

string

422

Validation failed

object

type

required

URL identifying the problem type

string format: uri

title

required

Short human-readable summary

string

status

required

HTTP status code

integer

detail

Human-readable explanation

string

request_id

Server-generated request identifier

string

errors

Validation error array (422 only)

Array<object>

object

field

required

Field path that failed validation

string

code

required

Validation error code

string

message

required

Human-readable validation message

string