Get account collection by ID
Lists the linked accounts in a collection, identified by its UUID. A collection groups one or more linked accounts under a single client, household, or partner workflow.
Endpoint
http
GET /v1/api/account/collection/{collectionId}Authentication: Bearer token.
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| collectionId | path | string (uuid) | Yes | Unique identifier of the account collection. |
Example request
bash
curl -X GET 'https://api.turnqey.xyz/v1/api/account/collection/123e4567-e89b-12d3-a456-426614174000' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <token>'Example response
result is an array, one entry per linked account.
json
{
"statusCode": 200,
"message": "GET Request successful.",
"isError": false,
"result": [
{
"accountId": "0f1e2d3c-4b5a-4c6d-8e9f-0a1b2c3d4e5f",
"type": "coinbase"
},
{
"accountId": "9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d",
"type": "gemini"
}
]
}| Field | Type | Description |
|---|---|---|
| result[].accountId | string (uuid) | Linked account UUID. Use it with the balances and transactions endpoints. |
| result[].type | string | Source platform: coinbase or gemini. |
Errors
| Status | Meaning |
|---|---|
| 401 | Bearer token missing, expired, or invalid. |
| 429 | Rate limit exceeded (300 requests per minute per source IP, per endpoint). Honour Retry-After. |
An unknown collection, or one that belongs to another partner, is not an error: the response is HTTP 200 with "result": [].
See Errors and Retries for the full error envelope and retry guidance.