Connections
List connection accounts
List the accounts available under a connection.
GET /teams/{teamId}/connections/{connectionId}/accounts
Returns the accounts available under the connection. Accounts that the team has enabled are returned first (status enabled), followed by the remaining accounts, each group sorted by name.
Authentication: Bearer token · Role: viewer · Permission:
connections:read · Rate limit: default (120 / 60s)Path parameters
teamId
string · uuid v7 required
The ID of the team the connection belongs to.
connectionId
string · uuid v7 required
The ID of the connection whose accounts to list.
Request
curl https://api.twominutereports.com/v1/teams/0190f8a0-1a2b-7c3d-9e4f-5a6b7c8d9e0f/connections/0190f8a1-2b3c-7d4e-8f90-1a2b3c4d5e6f/accounts \
-H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"success": true,
"data": [
{
"id": "1234567890",
"name": "Acme Inc — Main",
"displayId": "123-456-7890",
"description": "Manager account",
"accessible": true,
"status": "enabled",
"connectorId": "gadw"
},
{
"id": "9876543210",
"name": "Acme Inc — EU",
"displayId": "987-654-3210",
"description": null,
"accessible": true,
"status": "disabled",
"connectorId": "gadw"
}
]
}
{
"success": false,
"error": { "code": "BAD_REQUEST", "message": "Invalid UUID: \"abc\"" }
}
{
"success": false,
"error": { "code": "UNAUTHORIZED", "message": "Authentication required" }
}
Returned when the connection does not exist or does not belong to the team.
{
"success": false,
"error": { "code": "NOT_FOUND", "message": "The requested resource was not found" }
}
The account object
id
string
The provider-defined account identifier.
name
string
A human-friendly account name. Falls back to the account ID when no name is available.
displayId
string
A formatted, display-friendly version of the account ID.
description
string | null
An optional description of the account, or
null if none is provided.accessible
boolean
Whether the connection's credentials can currently access this account.
status
string
Either
enabled (the team has turned this account on) or disabled.connectorId
string
The connector this account belongs to (e.g.
gadw).