Skip to content

List contacts

GET /lists/{id}/contacts

ParamTypeDefaultDescription
status_filterstringOne of valid, invalid, risky, unknown.
limitint100Max 1000.
offsetint0
Terminal window
curl "https://mail.3ava.com/api/lists/list_a1b2.../contacts?status_filter=valid&limit=50" \
-H "Authorization: Bearer am_YOUR_KEY"
{
"data": [
{
"id": "ct_abc123",
"email": "[email protected]",
"first_name": "Maria",
"last_name": "Santos",
"phone": "+15551234567",
"company": null,
"custom_fields": {"state": "CA"},
"verification_status": "valid",
"verified_at": "2026-04-22T22:31:00Z",
"bounced_at": null,
"unsubscribed_at": null,
"created_at": "2026-04-22T22:30:00Z"
}
]
}