Get account collection by ID
Retrieves account information for a specific 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
json
{
"isError": false,
"message": "Success",
"result": {
"collectionId": "123e4567-e89b-12d3-a456-426614174000",
"accounts": [
{
"accountId": "98765432-e89b-12d3-a456-426614174000",
"platform": "coinbase",
"status": "active"
}
]
},
"statusCode": 200
}Errors
| Status | Meaning |
|---|---|
| 401 | Bearer token missing, expired, or invalid. |
| 404 | Collection not found. |
See Errors and Retries for the full error envelope and retry guidance.