Agency Partners
List Clients
Lists your agency's clients, oldest first, including clients added after the key was made.
https://app.tryredrover.com/api/public/v1/clientsclients:readNeeds a partner key; any other key or a connected AI app gets 403.
A sandbox key lists sandbox clients only.
Headers
AuthorizationstringRequiredBearerfollowed by anrr_live_API key or a connected app's access token. See Authentication.
Query Parameters
limitintegerHow many results to return, 1 to 100 (default 25)
1 to 100 · default 25
offsetintegerHow many results to skip (default 0)
default 0
referencestringOnly the client with this reference
Response
200 A page of clients.
dataobject[]RequiredShow 6 Child FieldsHide Child Fields
idstringRequiredThe client's workspace ID (UUID)
namestringRequiredThe client's name
referencestringRequiredYour own ID for the client, like a CRM record
nullable
contactobjectRequiredWho you deal with at the client, for your records. Storing a contact sends no invite
Show 2 Child FieldsHide Child Fields
namestringRequiredYour contact's name
nullable
emailstringRequiredYour contact's email
nullable
sandboxbooleanRequiredTrue for clients made with a sandbox key
createdAtstringRequiredISO 8601 datetime
paginationobjectRequiredShow 3 Child FieldsHide Child Fields
limitintegerRequiredPage size used for this response
offsetintegerRequiredHow many results were skipped
hasMorebooleanRequiredTrue when more results follow at a higher offset
Errors
Every error uses the error envelope.
400limit or offset is not valid401The Authorization header is missing, or the key is invalid or revoked403The key lacks the endpoint's scope, or cannot reach the workspace429More than 120 requests in a minute. Wait for Retry-After seconds500Something went wrong on our side
curl "https://app.tryredrover.com/api/public/v1/clients?reference=crm-1042" \
-H "Authorization: Bearer $REDROVER_API_KEY"{
"data": [
{
"id": "8f14e45f-ceea-4e1a-9c2b-6d7a1c3b9e21",
"name": "Acme Analytics",
"reference": "crm-1042",
"contact": {
"name": "Jane Smith",
"email": "jane@acme.com"
},
"sandbox": false,
"createdAt": "2026-11-16T10:00:00Z"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"hasMore": false
}
}