Contacts
GET List contacts
List contacts with full-text and tag filters.
Endpoint
GET https://api.aiconnectos.com/v1/contactsCursor-paginated, ordered by createdAt desc.
Query parameters
| Param | Type | Notes |
|---|---|---|
limit | int | 1-100, default 50. |
cursor | string | From the previous response's nextCursor. |
q | string | Full-text match on firstName + lastName + email + phone. |
tag | string | Repeatable. Returns contacts that have ALL specified tags. |
createdAfter | iso8601 | |
createdBefore | iso8601 | |
companyId | uuid |
Response
{
"data": [
{
"id": "ctc_…",
"firstName": "Jane",
"lastName": "Doe",
"email": "jane@example.com",
"phone": "+15558675309",
"tags": ["lead"],
"createdAt": "2026-05-25T20:14:00Z"
}
],
"nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI2…"
}Example
curl 'https://api.aiconnectos.com/v1/contacts?q=jane&tag=lead&limit=20' \
-H "Authorization: Bearer $STRIDE_API_KEY"