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",
      "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": "fb",
      "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 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

string

The provider-defined account ID. Use it as accountId when linking or unlinking 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 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).

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 linked this account to the client, or null for links created 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 linked accounts for a single connector.