Get account by identity

Try this endpoint in the interactive API Playground

Retrieves account information for a specific identity string, such as a partner-side user or client identifier.

Endpoint

http

GET /v1/api/account/identity/{identity}

Authentication: Bearer token.

Parameters

Parameter	In	Type	Required	Description
identity	path	string	Yes	Account identity string used by the partner system.

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

{
  "isError": false,
  "message": "Success",
  "result": {
    "identity": "account-identity-1234",
    "accountId": "98765432-e89b-12d3-a456-426614174000",
    "platform": "coinbase"
  },
  "statusCode": 200
}

Errors

Status	Meaning
401	Bearer token missing, expired, or invalid.
404	Identity not found.

See Errors and Retries for the full error envelope and retry guidance.