Clients
List client accounts
List the connector accounts linked to a client, across all connectors.
GET /teams/{teamId}/clients/{clientId}/accounts
Returns every connector account linked to the client, across all connectors. Accounts are sorted with enabled accounts first, then by name. To narrow the list to a single connector, see List client accounts by connector.
Authentication: Bearer token · Role: viewer · Permission:
clients:read · Rate limit: default (120 / 60s)Path parameters
teamId
string · uuid v7 required
The team the client belongs to.
clientId
string · uuid v7 required
The ID of the client whose linked accounts to list.
Request
curl https://api.twominutereports.com/v1/teams/0190f8b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/clients/0190f8c0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/accounts \
-H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
Returns an array of account objects. The array is empty if no accounts are linked.
{
"success": true,
"data": [
{
"id": "1234567890",
"name": "Acme – Google Ads",
"displayId": "123-456-7890",
"description": "Manager account",
"accessible": true,
"status": "enabled",
"connectorId": "gadw"
},
{
"id": "act_9876543210",
"name": "Acme – Meta Ads",
"displayId": "act_9876543210",
"description": null,
"accessible": true,
"status": "disabled",
"connectorId": "fb"
}
]
}
Returned when the client does not exist or does not belong to this team.
{
"success": false,
"error": { "code": "NOT_FOUND", "message": "Client not found" }
}
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" }
}
The account object
name
string
A human-readable label for the account. Falls back to the account ID when no label is available.
displayId
string
The account's display identifier as shown by the provider. Falls back to the account ID when not available.
description
string | null
An optional description or tooltip for the account, or
null.accessible
boolean
Whether the account is currently reachable through its connection.
status
string
Whether the account is enabled at the team level —
enabled or disabled.connectorId
string
The connector the account belongs to (a fixed connector ID, e.g.
gadw, fb).