Skip to main content
GET
Returns all contacts associated with your account. Results are sorted by signup date in descending order (newest first). Use query parameters to filter by sending list or active/inactive subscription status.

Query Parameters

string
Filter contacts by sending list phone number. Must be in E.164 format (e.g., +18005551234).
string
Filter by subscription status. Pass "true" to return only active (subscribed) contacts, or "false" to return only inactive (unsubscribed) contacts. Omit to return all contacts regardless of status.
integer
default:"1"
Page number for pagination.
integer
default:"50"
Number of contacts per page. Maximum value is 1000.

Response Fields

array
Array of contact objects.
object
Pagination metadata.

Examples

Error Codes

Next Steps

Importing Contacts

Import contacts in bulk

Create Audience

Segment your contacts into audiences