Clients

List client accounts

List the accounts assigned to a client, across all connectors.

GET /teams/{teamId}/clients/{clientId}/accounts

Returns every account assigned 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 · Permission:clients:read · Team permission:client_accounts.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 assigned 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 assigned.

{
  "success": true,
  "data": [
    {
      "id": "1234567890",
      "name": "Acme – Google Ads",
      "displayId": "123-456-7890",
      "description": "Manager account",
      "accessible": true,
      "status": "enabled",
      "connectorId": "gadw",
      "enabledBy": {
        "id": "0190f8b7-3c4d-7e5f-9a0b-1c2d3e4f5a6b",
        "name": "Priya Raman",
        "avatarUrl": null,
        "email": "[email protected]"
      },
      "createdBy": {
        "id": "0190f8b7-3c4d-7e5f-9a0b-1c2d3e4f5a6b",
        "name": "Priya Raman",
        "avatarUrl": null,
        "email": "[email protected]"
      },
      "updatedBy": null
    },
    {
      "id": "act_9876543210",
      "name": "Acme – Meta Ads",
      "displayId": "act_9876543210",
      "description": null,
      "accessible": true,
      "status": "disabled",
      "connectorId": "fads",
      "enabledBy": null,
      "createdBy": {
        "id": "0190f8b8-4d5e-7f6a-8b1c-2d3e4f5a6b7c",
        "name": "Arun Menon",
        "avatarUrl": null,
        "email": "[email protected]"
      },
      "updatedBy": null
    }
  ]
}

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 the key holder is not a member of the team.

{
  "success": false,
  "error": { "code": "FORBIDDEN", "message": "Access denied" }
}

The account object

string

The provider-defined account ID. Use it as accountId when you assign or unassign accounts.

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 team has enabled the account: enabled or disabled.

connectorId

string

The connector the account belongs to (a fixed connector ID, for example gadw or fads).

enabledBy

object | null

The user who enabled the account at team level, or null if it is disabled or was enabled before we started recording this.

createdBy

object | null

The user who assigned this account to the client, or null for assignments made before we started recording it.

updatedBy

object | null

The user who last edited it, or null if it has not been edited since it was created. Background refreshes never overwrite this. It always names a person.

Get client

Retrieve a single client by its ID.

List client accounts by connector

List a client's assigned accounts for a single connector.