# Listing account transactions

## List account transactions

<mark style="color:green;">`GET`</mark> `/api/public/v1/accounts/:account_id/transactions`

This endpoint returns the complete transaction history for a single account ID.

**Headers**

| Name          | Value                      |
| ------------- | -------------------------- |
| Content-Type  | `application/vnd.api+json` |
| Authorization | `Bearer <api_key>`         |

**Path Parameters**

| Name        | Type   | Description |
| ----------- | ------ | ----------- |
| account\_id | string | Account ID. |

**URL Parameters**

<table><thead><tr><th width="183">Name</th><th width="92">Type</th><th>Description</th></tr></thead><tbody><tr><td>order</td><td>string</td><td>Order in which the list of transactions should be returned. Can be either <code>created_at</code>, <code>amount</code> or <code>balance</code>.</td></tr><tr><td>order_type</td><td>string</td><td>Order type. Can be either <code>asc</code> or <code>desc</code>.</td></tr><tr><td>per_page</td><td>number</td><td>Number of transactions per page to return.</td></tr><tr><td>page</td><td>number</td><td>Page for which you want to return transactions.</td></tr><tr><td>created_at_from</td><td>string</td><td>Date and time filter. Supports timestamps in ISO 8601 format, e.g. <code>2024-06-18T15:49:02.031Z</code>.</td></tr><tr><td>created_at_to</td><td>string</td><td>Date and time filter. Supports timestamps in ISO 8601 format, e.g. <code>2024-06-18T15:49:02.031Z</code>.</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="HTTP 200" %}

```json
{
  "data": [
    {
      "id": "28e51afe-a9f9-43f1-9204-cc90a7deb4f2",
      "type": "transactions",
      "attributes": {
        "createdAt": "2024-06-18T15:49:02.031Z",
        "simplifiedState": "completed",
        "transactionType": "CoinTransaction",
        "amount": "0.00010000",
        "balance": "0.20087774"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "accounts",
            "id": "5850abb7-0a60-4041-800c-1d43b4dcf4d6"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "5850abb7-0a60-4041-800c-1d43b4dcf4d6",
      "type": "accounts",
      "attributes": {
        "currencyCode": "BTC",
        "balance": "0.20087774",
        "currencyType": "crypto"
      },
      "relationships": {
        "company": {
          "meta": {
            "included": false
          }
        },
        "networks": {
          "meta": {
            "included": false
          }
        }
      }
    }
  ],
  "meta": {
    "page": null,
    "per_page": "1",
    "total": 78
  },
  "jsonapi": {
    "version": "1.0"
  }
}
```

{% endtab %}
{% endtabs %}

**Response Body**

<table><thead><tr><th>Name</th><th width="99">Type</th><th>Description</th></tr></thead><tbody><tr><td>data.id</td><td>string</td><td>Transaction ID.</td></tr><tr><td>data.type</td><td>string</td><td>Entity type returned. Always <code>transactions</code>.</td></tr><tr><td>data.attributes</td><td>object</td><td>A set of transaction attributes.</td></tr><tr><td>data.attributes.createdAt</td><td>string</td><td>Transaction creation timestamp in UTC+0. Refer to the <a href="../api-basics/date-and-time-format">Date and time format</a> page.</td></tr><tr><td>data.attributes.simplifiedState</td><td>string</td><td>Transaction status.</td></tr><tr><td>data.attributes.transactionType</td><td>string</td><td>Transaction type. Can be either <code>ExchangeTransaction</code>, <code>CoinTransaction</code> or <code>ManualTransaction</code>.</td></tr><tr><td>data.attributes.amount</td><td>string</td><td>Transaction amount.</td></tr><tr><td>data.attributes.balance</td><td>string</td><td>This is what your account balance was when Txn processed the transaction.</td></tr><tr><td>data.relationships</td><td>object</td><td>Additional data on the transaction relationship.</td></tr><tr><td>data.relationships.account.type</td><td>string</td><td>Type of the entity returned in the <code>data.relationships.account.id</code> string. Always <code>accounts</code>.</td></tr><tr><td>data.relationships.account.id</td><td>string</td><td>Account ID which the transaction belongs to.</td></tr><tr><td>meta</td><td>object</td><td>Object that contains the pagination data.</td></tr><tr><td>meta.page</td><td>string</td><td>Current page number you are on.</td></tr><tr><td>meta.per_page</td><td>string</td><td>Number of transactions per page.</td></tr><tr><td>meta.total</td><td>number</td><td>Total number of pages returned.</td></tr></tbody></table>