# Transactions

SwitchWallet Enable you to get a paginated data of all your transactions (Deposit and Withdrawals) with Endless Options(filters), Thereby allowing you to filter out a particular or list of transaction with our optional parameter below

## Parameters

<table><thead><tr><th width="204">Parameter</th><th width="91.33333333333331"></th><th width="97">Status</th><th>Description</th></tr></thead><tbody><tr><td><a href="/pages/yi3ip2OyO6a83ibfPbws#1-currency-this-is-an-enum">Currency</a></td><td>Enum</td><td>Optional</td><td><a href="/pages/yi3ip2OyO6a83ibfPbws#1-currency-this-is-an-enum">View Schema</a></td></tr><tr><td><a href="/pages/yi3ip2OyO6a83ibfPbws#2-networkchain-this-is-also-an-enum">NetworkChain</a></td><td>Enum</td><td>Optional</td><td><a href="/pages/yi3ip2OyO6a83ibfPbws#2-networkchain-this-is-also-an-enum">View Schema</a></td></tr><tr><td>Status</td><td>Enum</td><td>Optional</td><td>Enum {Successful=1, Failed=2}</td></tr><tr><td>TransactionHash</td><td>string</td><td>Optional</td><td>Hash of a transaction</td></tr><tr><td>WalletAddress</td><td>string</td><td>Optional</td><td>Address involved in the transaction</td></tr><tr><td>TransactionType</td><td>Enum</td><td>Optional</td><td>Enum {Deposit=1, Withdrawal=2}</td></tr><tr><td>Page</td><td>number</td><td>Optional</td><td>Page No, Defaults to 1 </td></tr><tr><td>PageSize</td><td>number</td><td>Optional</td><td>PageSize, Defaults to 30 per page</td></tr><tr><td>StartTimeStamp</td><td>number</td><td>Optional</td><td>Starting date in timestamp format</td></tr><tr><td>EndTimeStamp</td><td>number</td><td>Optional</td><td>Ending date in timestamp format</td></tr></tbody></table>

Getting all transaction

<mark style="color:blue;">`GET`</mark> `Baseurl/api/v2/analytics/transaction-record`

Without the above parameters

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

```javascript
{
    "data": {
    "records": [
      {
        "transactionStatus": "SUCCESSFUL",
        "transactionType": "Deposit",
        "transactionHash": "0x82f560dbaff596e451828af86571eb0cd3e52c0f291810f07ea72189db4a8722",
        "transactionHashUrl": "https://testnet.bscscan.com/tx/0x82f560dbaff596e451828af86571eb0cd3e52c0f291810f07ea72189db4a8722",
        "toAddress": "0x4769FB8cBb51535533a485fD91d1649a688af192",
        "fromAddress": "0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "toAddressUrl": "https://testnet.bscscan.com/address/0x4769FB8cBb51535533a485fD91d1649a688af192",
        "fromAddressUrl": "https://testnet.bscscan.com/address/0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "amount": 20,
        "network": "BSC",
        "currency": "BUSD",
        "transactionTimeStamp": 0,
        "reference": "XF-WREF-613b528697ea52d266d73ed3",
        "createdAt": "2021-09-10T12:41:45.4537541"
      },
      {
        "transactionStatus": "SUCCESSFUL",
        "transactionType": "Deposit",
        "transactionHash": "0xe568b0e0a9f7565140c946c7aee637984515079196a3fddfc1aab66aa802ed5b",
        "transactionHashUrl": "https://testnet.bscscan.com/tx/0xe568b0e0a9f7565140c946c7aee637984515079196a3fddfc1aab66aa802ed5b",
        "toAddress": "0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddress": "0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "toAddressUrl": "https://testnet.bscscan.com/address/0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddressUrl": "https://testnet.bscscan.com/address/0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "amount": 1.23,
        "network": "BSC",
        "currency": "BUSD",
        "transactionTimeStamp": 0,
        "reference": "XF-WREF-6148c6312678ea10462bec80",
        "createdAt": "2021-09-20T17:34:43.6280348"
      },
      {
        "transactionStatus": "FAILED",
        "transactionType": "Withdrawal",
        "transactionHash": "0xb1c183590f0782fd5d64f5c848421c1d7ce8948ae074511851cd1ebef74e1557",
        "transactionHashUrl": "https://testnet.bscscan.com/tx/0xb1c183590f0782fd5d64f5c848421c1d7ce8948ae074511851cd1ebef74e1557",
        "toAddress": "0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddress": "0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "toAddressUrl": "https://testnet.bscscan.com/address/0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddressUrl": "https://testnet.bscscan.com/address/0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "amount": 1.32,
        "network": "BSC",
        "currency": "BUSD",
        "transactionTimeStamp": 0,
        "reference": "XF-WREF-6148c65b2678ea10462bfd0a",
        "createdAt": "2021-09-20T17:35:24.8637116"
      },
      {
        "transactionStatus": "FAILED",
        "transactionType": "Withdrawal",
        "transactionHash": "0x5fb75f8680a2f05bb7dc910976007a91cb6e39ff52268295544653401f8f0174",
        "transactionHashUrl": "https://testnet.bscscan.com/tx/0x5fb75f8680a2f05bb7dc910976007a91cb6e39ff52268295544653401f8f0174",
        "toAddress": "0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddress": "0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "toAddressUrl": "https://testnet.bscscan.com/address/0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddressUrl": "https://testnet.bscscan.com/address/0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "amount": 5.1,
        "network": "BSC",
        "currency": "BUSD",
        "transactionTimeStamp": 0,
        "reference": "XF-WREF-6148c7df2678ea10462c95de",
        "createdAt": "2021-09-20T17:41:52.6894277"
      } ],
    "pageSize": 30,
    "currentPage": 1,
    "totalPages": 2,
    "totalRecords": 40
  },
  "isSuccessful": true,
  "message": null,
  "httpStatusCode": 200,
}
```

{% endtab %}
{% endtabs %}

In the above Api call response are

```
    "pageSize": 30,
    "currentPage": 1,
    "totalPages": 2,
    "totalRecords": 40
```

This simply means merchant only 40 transactions in our system, Since PageSize parameter wasn't added, it defaults to return just 30 data in a single page arrange by date(most recent to recent) which is good for merchant's client side to load faster.

This Also means that remaining 10 data await you in page 2, To get it, Add page parameter and set it to "2"

## With  Page = 2

<mark style="color:blue;">`GET`</mark> `Baseurl/api/v2/analytics/transaction-record`

#### Query Parameters

| Name | Type   | Description |
| ---- | ------ | ----------- |
| page | number | 2           |

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

```javascript
{
    "data": {
    "records": [
      {
        "transactionStatus": "SUCCESSFUL",
        "transactionType": "Deposit",
        "transactionHash": "0x82f560dbaff596e451828af86571eb0cd3e52c0f291810f07ea72189db4a8722",
        "transactionHashUrl": "https://testnet.bscscan.com/tx/0x82f560dbaff596e451828af86571eb0cd3e52c0f291810f07ea72189db4a8722",
        "toAddress": "0x4769FB8cBb51535533a485fD91d1649a688af192",
        "fromAddress": "0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "toAddressUrl": "https://testnet.bscscan.com/address/0x4769FB8cBb51535533a485fD91d1649a688af192",
        "fromAddressUrl": "https://testnet.bscscan.com/address/0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "amount": 20,
        "network": "BSC",
        "currency": "BUSD",
        "transactionTimeStamp": 0,
        "reference": "XF-WREF-613b528697ea52d266d73ed3",
        "createdAt": "2021-09-10T12:41:45.4537541"
      },
      {
        "transactionStatus": "SUCCESSFUL",
        "transactionType": "Deposit",
        "transactionHash": "0xe568b0e0a9f7565140c946c7aee637984515079196a3fddfc1aab66aa802ed5b",
        "transactionHashUrl": "https://testnet.bscscan.com/tx/0xe568b0e0a9f7565140c946c7aee637984515079196a3fddfc1aab66aa802ed5b",
        "toAddress": "0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddress": "0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "toAddressUrl": "https://testnet.bscscan.com/address/0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddressUrl": "https://testnet.bscscan.com/address/0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "amount": 1.23,
        "network": "BSC",
        "currency": "BUSD",
        "transactionTimeStamp": 0,
        "reference": "XF-WREF-6148c6312678ea10462bec80",
        "createdAt": "2021-09-20T17:34:43.6280348"
      },
      {
        "transactionStatus": "FAILED",
        "transactionType": "Withdrawal",
        "transactionHash": "0xb1c183590f0782fd5d64f5c848421c1d7ce8948ae074511851cd1ebef74e1557",
        "transactionHashUrl": "https://testnet.bscscan.com/tx/0xb1c183590f0782fd5d64f5c848421c1d7ce8948ae074511851cd1ebef74e1557",
        "toAddress": "0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddress": "0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "toAddressUrl": "https://testnet.bscscan.com/address/0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddressUrl": "https://testnet.bscscan.com/address/0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "amount": 1.32,
        "network": "BSC",
        "currency": "BUSD",
        "transactionTimeStamp": 0,
        "reference": "XF-WREF-6148c65b2678ea10462bfd0a",
        "createdAt": "2021-09-20T17:35:24.8637116"
      },
      {
        "transactionStatus": "FAILED",
        "transactionType": "Withdrawal",
        "transactionHash": "0x5fb75f8680a2f05bb7dc910976007a91cb6e39ff52268295544653401f8f0174",
        "transactionHashUrl": "https://testnet.bscscan.com/tx/0x5fb75f8680a2f05bb7dc910976007a91cb6e39ff52268295544653401f8f0174",
        "toAddress": "0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddress": "0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "toAddressUrl": "https://testnet.bscscan.com/address/0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddressUrl": "https://testnet.bscscan.com/address/0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "amount": 5.1,
        "network": "BSC",
        "currency": "BUSD",
        "transactionTimeStamp": 0,
        "reference": "XF-WREF-6148c7df2678ea10462c95de",
        "createdAt": "2021-09-20T17:41:52.6894277"
      } ],
    "pageSize": 30,
    "currentPage": 2,
    "totalPages": 2,
    "totalRecords": 40
  },
  "isSuccessful": true,
  "message": null,
  "httpStatusCode": 200,
}
```

{% endtab %}
{% endtabs %}

Increase **PageSize** to "50", This means the whole data(40) plus even 10 more(if there is) can fit into this  one page

## With  PageSize = 50

<mark style="color:blue;">`GET`</mark> `Baseurl/api/v2/analytics/transaction-record`

#### Query Parameters

| Name     | Type   | Description |
| -------- | ------ | ----------- |
| pageSize | number | 2           |

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

```javascript
{
    "data": {
    "records": [
      {
        "transactionStatus": "SUCCESSFUL",
        "transactionType": "Deposit",
        "transactionHash": "0x82f560dbaff596e451828af86571eb0cd3e52c0f291810f07ea72189db4a8722",
        "transactionHashUrl": "https://testnet.bscscan.com/tx/0x82f560dbaff596e451828af86571eb0cd3e52c0f291810f07ea72189db4a8722",
        "toAddress": "0x4769FB8cBb51535533a485fD91d1649a688af192",
        "fromAddress": "0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "toAddressUrl": "https://testnet.bscscan.com/address/0x4769FB8cBb51535533a485fD91d1649a688af192",
        "fromAddressUrl": "https://testnet.bscscan.com/address/0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "amount": 20,
        "network": "BSC",
        "currency": "BUSD",
        "transactionTimeStamp": 0,
        "reference": "XF-WREF-613b528697ea52d266d73ed3",
        "createdAt": "2021-09-10T12:41:45.4537541"
      },
      {
        "transactionStatus": "SUCCESSFUL",
        "transactionType": "Deposit",
        "transactionHash": "0xe568b0e0a9f7565140c946c7aee637984515079196a3fddfc1aab66aa802ed5b",
        "transactionHashUrl": "https://testnet.bscscan.com/tx/0xe568b0e0a9f7565140c946c7aee637984515079196a3fddfc1aab66aa802ed5b",
        "toAddress": "0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddress": "0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "toAddressUrl": "https://testnet.bscscan.com/address/0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddressUrl": "https://testnet.bscscan.com/address/0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "amount": 1.23,
        "network": "BSC",
        "currency": "BUSD",
        "transactionTimeStamp": 0,
        "reference": "XF-WREF-6148c6312678ea10462bec80",
        "createdAt": "2021-09-20T17:34:43.6280348"
      },
      {
        "transactionStatus": "FAILED",
        "transactionType": "Withdrawal",
        "transactionHash": "0xb1c183590f0782fd5d64f5c848421c1d7ce8948ae074511851cd1ebef74e1557",
        "transactionHashUrl": "https://testnet.bscscan.com/tx/0xb1c183590f0782fd5d64f5c848421c1d7ce8948ae074511851cd1ebef74e1557",
        "toAddress": "0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddress": "0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "toAddressUrl": "https://testnet.bscscan.com/address/0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddressUrl": "https://testnet.bscscan.com/address/0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "amount": 1.32,
        "network": "BSC",
        "currency": "BUSD",
        "transactionTimeStamp": 0,
        "reference": "XF-WREF-6148c65b2678ea10462bfd0a",
        "createdAt": "2021-09-20T17:35:24.8637116"
      },
      {
        "transactionStatus": "FAILED",
        "transactionType": "Withdrawal",
        "transactionHash": "0x5fb75f8680a2f05bb7dc910976007a91cb6e39ff52268295544653401f8f0174",
        "transactionHashUrl": "https://testnet.bscscan.com/tx/0x5fb75f8680a2f05bb7dc910976007a91cb6e39ff52268295544653401f8f0174",
        "toAddress": "0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddress": "0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "toAddressUrl": "https://testnet.bscscan.com/address/0xfa2720e1B11Ff8ec945e2DfDC2FbFC8Ebb5F7fEB",
        "fromAddressUrl": "https://testnet.bscscan.com/address/0xc38ee0Df48303D1D271d8922E5ce7FcF36BD281b",
        "amount": 5.1,
        "network": "BSC",
        "currency": "BUSD",
        "transactionTimeStamp": 0,
        "reference": "XF-WREF-6148c7df2678ea10462c95de",
        "createdAt": "2021-09-20T17:41:52.6894277"
      } ],
    "pageSize": 50,
    "currentPage": 1,
    "totalPages": 1,
    "totalRecords": 40
  },
  "isSuccessful": true,
  "message": null,
  "httpStatusCode": 200,
}
```

{% endtab %}
{% endtabs %}

**To get all transaction in a particular Network  eg "BSC" network,**

Solution: Call same Endpoint with [NetworkChain](/api-calls/wallet-generation.md#2-networkchain-this-is-also-an-enum) parameter with value "1"

| Problem                                              | Solution                                                                                                                         | parameter Value                                 |
| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
| To get all failed transactions                       | Call same Endpoint with Status=2                                                                                                 | 2                                               |
| Get the transaction a particular hash                | Call same Endpoint with TransactionHash= your hash                                                                               | your hash                                       |
| To get all transactions tied to WalletAddress        | Call same Endpoint with WalletAddress= yourWalletAddress                                                                         | yourWalletAddress                               |
| To get only Deposit transactions                     | Call same Endpoint with TransactionType= 1                                                                                       | 1                                               |
| To get all transactions between date "A" to date "B" | Call same Endpoint with  date  "A" coverted to TimeStamp  as StartTimeStamp and date  "B" coverted to TimeStamp  as EndTimeStamp | StartTimeStamp=45657379, EndTimeStamp= 88759578 |

{% hint style="info" %}
the above solution work for each Enum value in the [Pararmeter Table](#parameters)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.switchwallet.io/api-calls/transactions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.