list_all_contacts
Read-onlyIdempotent
Retrieve and filter contacts by criteria such as email, list, tag, or date. Search for specific contacts or list all contacts in your ActiveCampaign account.
Instructions
🟢 READ-ONLY · Contacts · GET /contacts
List, search, and filter contacts
Fetches data. Makes no changes to your ActiveCampaign account.
Use this API endpoint to list all contacts, search contacts, or filter contacts by many criteria. For example, search for specific contacts by email, list, account.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | Filter contacts by ID. Can be repeated for multiple IDs. Example: ids[]=1&ids[]=2&ids[]=42 | |
| No | Email address of the contact you want to get | ||
| limit | No | Number of results per page (ActiveCampaign default 20, max 100). | |
| phone | No | Filter contacts where the phone number starts with the given value | |
| tagid | No | Filter contacts associated with the given tag | |
| formid | No | Filter contacts associated with the given form | |
| listid | No | Filter contacts associated with the given list | |
| offset | No | Zero-based offset into the result set for pagination. | |
| orders | No | Sort order as an object, e.g. {"email":"ASC"} → orders[email]=ASC. | |
| search | No | Filter contacts that match the given value in the contact names, organization, phone or email | null |
| status | No | See [available values](https://developers.activecampaign.com/reference/contact) | |
| waitid | No | Filter by contacts in the wait queue of an automation block | |
| exclude | No | Exclude from the response the contact with the given ID | |
| filters | No | Field filters as an object, e.g. {"name":"ecom"} → filters[name]=ecom. | |
| id_less | No | Only include contacts with an ID less than the given ID | |
| seriesid | No | Filter contacts associated with the given automation | |
| orders_id | No | Order contacts by unique ID Sent to ActiveCampaign as "orders[id]". | ASC |
| segmentid | No | Return only contacts that match a list segment (the first call kicks off an asynchronous query. When the query is complete, subsequent API calls will return contacts that match the segment - timeout 1hr) | |
| email_like | No | Filter contacts that contain the given value in the email address | |
| id_greater | No | Only include contacts with an ID greater than the given ID | |
| orders_name | No | Order contacts by full name Sent to ActiveCampaign as "orders[name]". | |
| orders_cdate | No | Order contacts by creation date Sent to ActiveCampaign as "orders[cdate]". | |
| orders_email | No | Order contacts by email Sent to ActiveCampaign as "orders[email]". | ASC |
| orders_score | No | Order contacts by score Sent to ActiveCampaign as "orders[score]". | |
| organization | No | (Deprecated) Please use Account-Contact end points. Filter contacts associated with the given organization ID | |
| in_group_lists | No | Set this to "true" in order to return only contacts that the current user has permissions to see. | |
| orders_last_name | No | Order contacts by last name Sent to ActiveCampaign as "orders[last_name]". | |
| orders_first_name | No | Order contacts by first name Sent to ActiveCampaign as "orders[first_name]". | |
| filters_created_after | No | Filter contacts that were created after this date Sent to ActiveCampaign as "filters[created_after]". | |
| filters_updated_after | No | Filter contacts that were updated after this date Sent to ActiveCampaign as "filters[updated_after]". | |
| filters_created_before | No | Filter contacts that were created prior to this date Sent to ActiveCampaign as "filters[created_before]". | |
| filters_updated_before | No | Filter contacts that were updated before this date Sent to ActiveCampaign as "filters[updated_before]". |