Get account by identity
Resolves the linked account for a partner-side identity string, such as your own user or client identifier supplied when the account was authorized.
Endpoint
http
GET /v1/api/account/identity/{identity}Authentication: Bearer token.
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| identity | path | string | Yes | Identity string used by the partner system when authorizing the account. |
Example request
bash
curl -X GET 'https://api.turnqey.xyz/v1/api/account/identity/account-identity-1234' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <token>'Example response
json
{
"statusCode": 200,
"message": "GET Request successful.",
"isError": false,
"result": {
"accountId": "0f1e2d3c-4b5a-4c6d-8e9f-0a1b2c3d4e5f",
"type": "coinbase"
}
}| 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 identity is not an error: the response is HTTP 200 with "result": {}.
See Errors and Retries for the full error envelope and retry guidance.