POST list_clients
Clients with client type, trainer, tags and last activity.
read
Lists the clients you can see, in the order Trainerize shows them. Deactivated clients are left out unless you ask for them with client_type. Filter by tag to get a group, or search by name or email. Pages hold up to 200 clients; pass next_cursor back as cursor for the next page.
POST /api/v1/trainerize/list_clients
Input
| Parameter | Type | Description |
|---|---|---|
| client_type | enum | full_access, offline, basic, prospect, pending or deactivated. Default: all except deactivated. |
| tag | string | Only clients with this custom or auto client tag. |
| search | string | Match on name or email. |
| limit | integer | 1 to 200. Default: 50. |
| cursor | string | Next page cursor from the previous call. |
Example response
{
"clients": [
{
"client_id": "4821937",
"name": "Alex Rivera",
"email": "alex@example.com",
"client_type": "full_access",
"trainer": "yourname",
"tags": [
"Challenge"
],
"last_active": "2026-10-08T17:40:00Z"
},
{
"client_id": "4821944",
"name": "Sam Carter",
"email": "sam@example.com",
"client_type": "full_access",
"trainer": "yourname",
"tags": [
"Challenge",
"Online"
],
"last_active": "2026-10-09T06:12:00Z"
}
],
"next_cursor": null
}