Clients
List clients
List a team's clients.
GET /teams/{teamId}/clients
Returns the team's clients, ordered by name. Each entry is a full client object.
Authentication: Bearer token · Role: viewer · Permission:
clients:read · Rate limit: default (120 / 60s)Path parameters
teamId
string · uuid v7 required
The team whose clients to list.
Request
curl https://api.twominutereports.com/v1/teams/0190f8b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/clients \
-H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
Returns an array of client objects.
{
"success": true,
"data": [
{
"id": "0190f8c0-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
"name": "Acme Corp",
"domain": "acme.com",
"status": "active",
"metadata": {
"logoUrl": "https://assets.gox.ai/tmr/logos/acme.png",
"brandColor": "#0A66C2"
},
"link": "https://hub.twominutereports.com/clients/0190f8c0-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
"createdAt": "2026-01-12T08:15:00.000Z",
"updatedAt": "2026-05-20T11:42:00.000Z",
"createdBy": {
"id": "0190f8b7-3c4d-7e5f-9a0b-1c2d3e4f5a6b",
"name": "Priya Raman",
"avatarUrl": null,
"email": "[email protected]"
},
"updatedBy": {
"id": "0190f8b8-4d5e-7f6a-8b1c-2d3e4f5a6b7c",
"name": "Arun Menon",
"avatarUrl": null,
"email": "[email protected]"
}
}
]
}
{
"success": false,
"error": { "code": "UNAUTHORIZED", "message": "Authentication required" }
}
Returned when you are not a member of the team.
{
"success": false,
"error": { "code": "FORBIDDEN", "message": "You do not have permission to perform this action" }
}