Hello CEESI,
Thank you for reaching out to Constant Contact API Developer Support. My team is here to assist outside software developers with questions about building into Constant Contact's API.
When calling the GET /contacts endpoint, you'll need to make multiple calls, as the maximum number of entries that can be returned at a time is 500, but the results use pagination and will include a link to call for the next 500 results (until there are no more pages left).
GET Contacts Collection
https://v3.developer.constantcontact.com/api_reference/index.html#!/Contacts/getContacts
You'll start by making sure to include the "limit" query parameter in your call with a value of "500", otherwise it defaults to only 50 results. Additionally, if you are wanting to determine which contacts are or are not on lists, using the "include" query parameter with a value of "lists" will include the list IDs for each contact as well.
Example call:
GET https://api.cc.email/v3/contacts?include=list_memberships&limit=500
At the end of the 500 entries returned, if there are more than 500 results, you will see a section that looks similar to this at the very bottom of the response body:
"_links": {
"next": {
"href": "/v3/contacts?cursor={value}"
}
}
You will use this link to make another call to get the next page of results, like so:
Example Call:
GET https://api.cc.email/v3/contacts?cursor={value}
Then, if the results of the second call have a next link at the bottom of the response body, you will use that to make a third call, and so on.
Please have a look and let us know if you have any other questions!
Support Tips
"There's a multitude of ways to engage your audience through us using your social platforms - via ads, social post metrics, email links, and more! " - Will
See ArticleSupport Tips
"Target your most engaged contacts by creating a segment. Create a special offer or show your appreciation!" - Caitlin
See ArticleSupport Tips
"Greet new contacts with one or more automated Welcome Emails depending on their interests or your business goals." - Nick
See Article