# History

The transaction history displays all deposits and withdrawals from the user wallet. When building applications, try to keep the data as shallow as possible to reduce the data fetched. We added filter parameters to reduce the number of entries per page or pick a specific coin types that are referenced by their respective tokenID. 

```javascript
var parameters = {
    nextPageToken: 'optional',
    serviceId: 'optional',
    walletID: 'optional',
    type: 'optional',
}

const response = await relysia.wallet.v1.history(parameters);
```

{% hint style="info" %}
We currently integrate token transactions into the /history endpoint.
{% endhint %}

## Get your transaction history.

<mark style="color:blue;">`GET`</mark> `https://api.relysia.com/v1/history`

The transaction history endpoint returns all past transactions, both BSV and Tokens.

#### Query Parameters

| Name          | Type   | Description |
| ------------- | ------ | ----------- |
| nextPageToken | string |             |

#### Headers

| Name     | Type   | Description |
| -------- | ------ | ----------- |
| walletID | string |             |
| type     | string |             |
| version  | string |             |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
  "statusCode": 200,
  "data": {
    "status": "success",
    "msg": "Operation completed successfully",
    "histories": [
      {
        "version": "1.0.0",
        "to": "bulk transaction",
        "txId": "29f6d4ee36ffbb70226f342a89097e040df4cdbc91e15bb698d0bf27fa228956",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-09-15 05:25:49",
        "balance_change": -2,
        "docId": "29f6d4ee36ffbb70226f342a89097e040df4cdbc91e15bb698d0bf27fa228956",
        "notes": null,
        "type": "debit",
        "protocol": "STAS"
      },
      {
        "version": "1.0.0",
        "to": "1K1xqUS6nt2niaAcM7K5WuNWyqBaD8JQkN",
        "txId": "baf52af692ed06a2b9fa0e3c256b4e0d3259f6b651dce8c065d5b9d67e91e70c",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-09-15 05:14:38",
        "balance_change": -1,
        "docId": "baf52af692ed06a2b9fa0e3c256b4e0d3259f6b651dce8c065d5b9d67e91e70c",
        "notes": null,
        "type": "debit",
        "protocol": "STAS"
      },
      {
        "version": "1.0.0",
        "to": "payto:3577@relysia.com?amount=120",
        "txId": "d181897e8952e20b38256ba4893a2f2d7ae42ee627d74adcce49c9c6a4b0dd81",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-09-15 04:59:36",
        "balance_change": 0.0000012,
        "docId": "d181897e8952e20b38256ba4893a2f2d7ae42ee627d74adcce49c9c6a4b0dd81",
        "notes": "Send to 3577@relysia.com",
        "type": null,
        "protocol": "BSV"
      },
      {
        "version": "1.0.0",
        "to": "bulk transaction",
        "txId": "0397640d62d8dece842ec6209345de94d4ca9997f83aa31c7467c6060c3f39aa",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-09-15 04:45:39",
        "balance_change": -200,
        "docId": "0397640d62d8dece842ec6209345de94d4ca9997f83aa31c7467c6060c3f39aa",
        "notes": null,
        "type": "debit",
        "protocol": "BSV"
      },
      {
        "version": "1.0.0",
        "to": "1K1xqUS6nt2niaAcM7K5WuNWyqBaD8JQkN",
        "txId": "82f2852d3b0c327f3d67b3a8f96f90b69b312a36bad102b62b69622c8e26fc19",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-09-15 04:39:51",
        "balance_change": -100,
        "docId": "82f2852d3b0c327f3d67b3a8f96f90b69b312a36bad102b62b69622c8e26fc19",
        "notes": null,
        "type": "debit",
        "protocol": "BSV"
      },
      {
        "version": "1.0.0",
        "to": "1Abju7foXMqhBK8CbHVuRXLqTtmxFgTdRh",
        "txId": "b2d88f2b119e276f6c22e62b58ef33f8c572cc1a87c7fd8c0b52ad5c3c713690",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-09-07 16:49:17",
        "balance_change": -100,
        "docId": "b2d88f2b119e276f6c22e62b58ef33f8c572cc1a87c7fd8c0b52ad5c3c713690",
        "notes": null,
        "type": "debit",
        "protocol": "BSV"
      },
      {
        "version": "1.0.0",
        "to": "1L1ik3bjuJFgye8g4f2PYDtB3AAjjif2fK",
        "txId": "4408297291c835d6618105f313e3ebd130f86e3b363469fadc6d19768bde0570",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-08-11 04:38:06",
        "balance_change": -50000,
        "docId": "4408297291c835d6618105f313e3ebd130f86e3b363469fadc6d19768bde0570",
        "notes": null,
        "type": "debit",
        "protocol": "BSV"
      },
      {
        "version": "1.0.0",
        "to": "1FJ4Lt7B5ekcucefgT44VaiZffffZAAUUp",
        "txId": "c0c5761191674cf78d26b227e8faf51e52e1b0888adebec1863847d370f6311e",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-08-01 16:05:26",
        "balance_change": -50000,
        "docId": "c0c5761191674cf78d26b227e8faf51e52e1b0888adebec1863847d370f6311e",
        "notes": null,
        "type": "debit",
        "protocol": "BSV"
      },
      {
        "version": "1.0.0",
        "to": "17n2JVhrCf1oYSMkZtZNjcf1deteUEKQsH",
        "txId": "ddef95711560df8373a06d455d716cf2ce21322511b2ec9112a9bb387577859e",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-07-28 16:16:18",
        "balance_change": -500,
        "docId": "ddef95711560df8373a06d455d716cf2ce21322511b2ec9112a9bb387577859e",
        "notes": null,
        "type": "debit",
        "protocol": "BSV"
      },
      {
        "version": "1.0.0",
        "to": "17n2JVhrCf1oYSMkZtZNjcf1deteUEKQsH",
        "txId": "1dad4406281f7f5c899ab833a08a16958f194f102ca53ecbdf0f629824af8cba",
        "from": "1325@dev.relysia.com",
        "timestamp": "2022-07-28 16:11:46",
        "balance_change": -500,
        "docId": "1dad4406281f7f5c899ab833a08a16958f194f102ca53ecbdf0f629824af8cba",
        "notes": null,
        "type": "debit",
        "protocol": "BSV"
      }
    ],
    "nextPageTokenId": "2022-07-28T16:11:46.021Z"
  }
}
```

{% endtab %}
{% endtabs %}