Get contacts

Retrieve a list of contacts for a given application.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

Application's ID

Query Params
integer
1 to 100
Defaults to 25

Limit the number of contacts returned.

integer
≥ 0
Defaults to 0

Page number

string

Filters contacts by their code:

  • Up to 5 characters: Performs a prefix search (starts with).
  • More than 5 characters: Performs an exact match on the full code.
string

Filter contacts by externalCode.

boolean
Defaults to false

If true, returns the total count of contacts matching the filter along with the data.

string
enum

Optional field to order the contacts list by.

  • lastMessageId: Order contacts by their last message ID descending (most recent activity first). Contacts without messages appear last.
Allowed:
string
enum

Filter contacts by their latest contact center conversation:

  • active: latest conversation is assigned to an agent and not closed.
  • pending: latest conversation is not assigned to an agent and not closed.
  • closed: latest conversation is closed.
  • none: contact has no conversations.
  • omitted: all contacts.
Allowed:
boolean

Filter contacts by reactive messaging availability:

  • true: contacts that are not reactively blocked.
  • false: contacts that are reactively blocked.
  • omitted: all contacts.
Responses

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