List contacts

get

https://api.omnisend.com/v5/contacts

List contacts

Scopes:
contacts.read

Check POSTMAN documentation

Query Params

string

Email address.

phone

string

Full phone number.

status

string

enum

Email channel status. See endpoint description for available statuses.

Allowed:

segmentID

string

Segment ID.

tag

string

Contact tag

limit

integer

Defaults to 100

Number of results to fetch. Default is 100, max 250.

after

string

Paging cursor (base64). Without updatedAfter: base64-encoded contactID. With updatedAfter: base64-encoded JSON with id and updatedAt fields. Use next/previous URLs from the response.

before

string

Paging cursor (base64). Same format as after. Use next/previous URLs from the response.

updatedAfter

string

Filter contacts updated at or after this timestamp. RFC3339 format (e.g. 2024-01-01T00:00:00Z). Cannot be combined with other filters (email, phone, status, segmentID, tag).

Responses

200List of contacts

400Please use 'after' param from response instead of 'offset'