Joinotify

List contacts

GEThttps://api.joinotify.com/contacts

The contact base, paginated. Every filter adds up (AND).

With an API key limited to some numbers, the list only brings the contacts that have a conversation on those numbers.

Query Params

10 optional

integeroptional

Items per page.

min. 1max. 200default 50

integeroptional

How many items to skip. That is how you page.

min. 0default 0

stringoptional

recent: newest first. name: by name. last_inbound: whoever wrote last comes first.

Allowed values:recentnamelast_inbound

default recent

stringoptional

Search by name, email or phone (by digits, from 4 on).

max. 120 characters

stringoptional

Only contacts with this tag.

stringoptional

Marketing consent status.

Allowed values:opted_inopted_outunknown

stringoptional

How the contact entered the base.

Allowed values:manualimportapiinboundflowwebhooksite

stringoptional

Only contacts the saved audience selects.

stringoptional

Advanced filter: an audience condition tree, as JSON. See the AudienceFilter schema.

max. 20000 characters

stringoptional

Whose contacts: absent = this account's. all = this account's and every workspace it pays for, or one workspace's id. Only with the agency account's key without a number restriction (403 for any other); each contact then carries workspace.

Responses