Get account transactions
Returns the transaction history for a linked account, identified by its UUID.
Endpoint
http
GET /v1/api/account/{accountId}/transactionsAuthentication: Bearer token.
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| accountId | path | string (uuid) | Yes | Unique identifier of the linked account. |
| forceRefresh | query | boolean | No | Refresh from the source instead of the cache. Applies only when the cached data is older than 30 minutes, and is ignored while the account's first sync is still running. Defaults to false. |
There are no date-range filters. The full history is returned.
Example request
bash
curl -X GET 'https://api.turnqey.xyz/v1/api/account/0f1e2d3c-4b5a-4c6d-8e9f-0a1b2c3d4e5f/transactions?forceRefresh=false' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <token>'Example response
json
{
"statusCode": 200,
"message": "GET Request successful.",
"isError": false,
"result": {
"transactions": [
{
"type": "buy",
"title": "Bought BTC",
"subtitle": "Coinbase",
"header": "0.5 BTC",
"exchange": "coinbase",
"dateTime": "2026-09-12T15:04:05Z",
"amount": "24500.00",
"symbol": "BTC",
"volume": "0.5",
"fee": "12.25",
"price": "49000.00"
}
],
"lastUpdatedOn": "2026-10-30T14:00:00Z"
}
}| Field | Type | Description |
|---|---|---|
| result.transactions[].type | string | Transaction type as reported by the source (for example buy, sell, send, receive). |
| result.transactions[].title | string | Human-readable label. |
| result.transactions[].subtitle | string | Secondary label, usually the source platform. |
| result.transactions[].header | string | Short summary, usually the quantity and symbol. |
| result.transactions[].exchange | string | Source platform: coinbase or gemini. |
| result.transactions[].dateTime | string (date-time) | When the transaction happened. |
| result.transactions[].amount | string | Fiat amount of the transaction. |
| result.transactions[].symbol | string | Asset symbol. |
| result.transactions[].volume | string | Asset quantity. |
| result.transactions[].fee | string | Fee charged by the source. |
| result.transactions[].price | string | Asset price at the time of the transaction. |
| result.lastUpdatedOn | string (date-time) | When the snapshot was last refreshed from the source. |
| result.dataFreshness | object | Present only when the snapshot is stale: {status, asOf, ageHours, reason}. See Data Freshness. |
Numeric values are returned as strings to preserve precision.
Errors
| Status | Meaning |
|---|---|
| 401 | Bearer token missing, expired, or invalid. |
| 404 | No active connection exists for the supplied accountId. |
| 409 | Reserved: the account must be re-authorized before data can be served. Not enabled in production today; the same condition is signalled through dataFreshness.status. |
| 429 | Rate limit exceeded (300 requests per minute per source IP, per endpoint). Honour Retry-After. |
See Data Freshness for caching and refresh behavior, and Errors and Retries for error handling.