Contacts

List contacts

GET/api/v1/contactsScope contacts:read

Every contact of the agency, oldest change first, paged like trips.

Query parameters

typecomma-separated listoptional

Comma-separated list of contact types, for example traveler,prospect. Omit it to get every type.

travelerprospectpartnersupplierother

updated_sincetimestampoptional

Only objects changed at or after this instant. ISO 8601, for example 2026-09-26T00:00:00Z.

limitintegeroptionalDefault 50

How many objects per page, from 1 to 200.

cursorstringoptional

The next_cursor from the previous page. Keep the other parameters the same while you follow it: changing a filter changes the result set and can skip objects.

Returns

A list of Contact objects.

object"list"

dataarray of Contact

next_cursorstring or null

Errors

401unauthorizedNo key, a malformed one, or a key that does not exist or was revoked. Send it as Authorization: Bearer <key>.

403api_not_enabledRoundPlan has not turned on API access for this agency.

403subscription_inactiveThe agency's trial expired or its subscription ended.

403insufficient_scopeThe key cannot read this. An owner adds contacts:read to a key in Settings → API.

400invalid_requestA query parameter is not valid. The message says which.

429rate_limitedToo many requests. Wait the seconds in Retry-After. See Errors and rate limits.

500internal_errorSomething went wrong on our side. Retry later.