List and search contacts

A page of contacts, filtered and sorted. Filters combine. Keep requesting with cursor until next_cursor is null: a page can hold fewer than limit contacts, even none, before the end. Paging follows the order as it is now, not a snapshot: a contact renamed while you page can move. Also answers HEAD.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
length ≤ 200

Search names, company, job title, caller ID name, e-mails, tags, and phone digits (three or more). Case- and accent-insensitive.

string

Contacts with this phone number, in any format. Only numbers with no extension match, unless extension names one.

string
length ≤ 20

With phone: contacts with that number and exactly this extension.

string
length ≤ 254

Contacts with this e-mail address, any case.

string
length ≤ 50

Contacts with this tag.

string
length ≤ 200

Contacts at exactly this company.

uuid

Contacts owned by this person.

boolean

true or false.

boolean

true or false.

string
enum
Defaults to saved

saved (the default), auto or any.

Allowed:
string

Up to 100 contact ids, comma-separated: those contacts, in that order; ones that don't exist or you may not see are left out. No other parameter goes with it.

string
enum
Defaults to name

name (the default: starred first, then alphabetical, accent-insensitive) or recent (latest activity first).

Allowed:
integer
1 to 200
Defaults to 50

How many contacts a page holds, 1 to 200.

string

The previous page's next_cursor. It carries the filters, so send it with nothing else but limit and with_total. It works only for the caller it was issued to and lasts 24 hours.

boolean

true adds meta.total.

uuid

For EMAK staff only: the account to read. Everyone else reads their own account and must leave it out.

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json