> For the complete documentation index, see [llms.txt](https://konnadex-docs.gitbook.io/konnadex-technologies/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://konnadex-docs.gitbook.io/konnadex-technologies/transactions.md).

# 📝 Transactions

Transactions are vital for businesses, hence we provide this API endpoint using which you can programmatically fetch and list all the transactions associated with your Konnadex account :

#### All Transactions <a href="#all-transactions" id="all-transactions"></a>

List all the transactions associated with your Konnadex account

### Fetch all transactions <a href="#fetch-all-transactions" id="fetch-all-transactions"></a>

`GET` [`https://api.konnadex.com/v1/collections`](https://api.konnadex.com/v1/collections)

List all the transactions associated with your Konnadex account

**Sample Request**

```javascript
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://api.konnadex.com/v1/collections',
  'headers': {
     'x-api-key': 'SECRET-KEY',
    'Content-Type': 'application/json'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
```

**Sample Response**

```javascript
{
  "items": [
    {
      "createdAt": "2024-03-18T15:37:18.941Z",
      "updatedAt": "2024-03-18T15:41:35.129Z",
      "deletedAt": null,
      "id": "d3b188d8-0f5a-4e25-ad2d-7a8b92ec8c06",
      "assetId": "USDT",
      "network": "BSC",
      "fee": "0.03",
      "amount": "3.29",
      "amountPaid": "3.29",
      "fiatAmount": "5000.00",
      "fiatRate": "1518.4",
      "fiatCurrency": ["NGN","USD","EUR","GBP","GHS","AUD","JPY"]
      "isTransfer": false,
      "recipientAddress": "0x60d4fe05c55c6982A23B860dEa602d6E09d74e1F",
      "addressBindTimestamp": "2024-03-18T15:37:18.898Z",
      "addressUnboundTimestamp": "2024-03-18T15:41:35.337Z",
      "transactionHash": "0x7d7837b03f3795a1d15d9fe360696a174be0d57ba46be09b52d635a8e493ad6d",
      "status": "complete",
      "bearer": "MERCHANT",
      "reference": "PLK_pj1pgscxltx3yway",
      "transactionReference": "KDX|ltx4022v|64c2y",
      "integratorId": "651298c28a73710b161bda70",
      "userId": "651298c28a73710b161bda6e",
      "metadata": {
        "phone": "+1204",
        "fullname": "Asogwa Emmanuel",
        "email": "asogwa@gmail.com",
        "address": "16192 Coastal Highway"
      },
      "__type": "Collections"
    },
    {
      "createdAt": "2024-03-18T12:45:10.599Z",
      "updatedAt": "2024-03-18T12:47:01.073Z",
      "deletedAt": null,
      "id": "70fa76b3-837a-4fc0-a293-648c3574c76f",
      "assetId": "USDT",
      "network": "BSC",
      "fee": "0.07",
      "amount": "6.59",
      "amountPaid": "6.59",
      "fiatAmount": "10000.00",
      "fiatRate": "1518.4",
      "fiatCurrency": ["NGN","USD","EUR","GBP","GHS","AUD","JPY"]
      "isTransfer": false,
      "recipientAddress": "0xD73dE0f40f76981a731637e0d27ad76df902159E",
      "addressBindTimestamp": "2024-03-18T12:45:10.561Z",
      "addressUnboundTimestamp": "2024-03-18T12:47:01.284Z",
      "transactionHash": "0x7b25b3c7596f3e7fd6731853fc1373ca89aae963e98ee92904a01b4726f48589",
      "status": "complete",
      "bearer": "MERCHANT",
      "reference": "PLK_fuaqx4ghltwxu95r",
      "transactionReference": "KDX|ltwxuoox|137wc",
      "integratorId": "651298c28a73710b161bda70",
      "userId": "651298c28a73710b161bda6e",
      "metadata": {
        "phone": "+2348135323878",
        "fullname": "Ugochukwu Gabriel Okoro",
        "email": "ugdesmond@gmail.com",
        "address": "38, Mbanefo street,New Haven ,Enugu ,Nigeria"
      },
      "__type": "Collections"
    }
],
  "meta": {
    "totalItems": 45,
    "itemCount": 20,
    "itemsPerPage": 20,
    "totalPages": 3,
    "currentPage": 1
  }
}
```

#### Get Transaction by Transaction Reference <a href="#get-transaction-by-transaction-reference" id="get-transaction-by-transaction-reference"></a>

Fetch a specific transaction using its transaction reference

### Fetch transaction by Reference <a href="#fetch-transaction-by-reference" id="fetch-transaction-by-reference"></a>

`GET`[ ](https://staging.konnadex.com/v1/collections/%7Breference%7D/verify)[https://api.konnadex.com/v1/collections/{reference}/verify](https://staging.konnadex.com/v1/collections/%7Breference%7D/verify)

**Path Parameters**

<table><thead><tr><th width="199">Name</th><th width="97">Type</th><th>Description</th></tr></thead><tbody><tr><td>:transaction_reference*</td><td>String</td><td>Supply a transaction reference</td></tr></tbody></table>

**Sample Request**

```javascript
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://api.konnadex.com/v1/collections/{reference}/verify',
  'headers': {
  'x-api-key':'SECRET-KEY',
  'Content-Type': 'application/json'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
```

**Sample Response**

```javascript
jav{
  "createdAt": "2024-03-25T09:25:47.142Z",
  "updatedAt": "2024-03-25T09:27:06.667Z",
  "deletedAt": null,
  "id": "8f48ea5a-6f8d-4d8a-b7bb-ad9c2ebf35a8",
  "assetId": "USDT",
  "network": "BSC",
  "fee": "0.07",
  "amount": "6.59",
  "amountPaid": "6.59",
  "fiatAmount": "10000.00",
  "fiatRate": "1518.4",
  "fiatCurrency": ["NGN","USD","EUR","GBP","GHS","AUD","JPY"]
  "isTransfer": false,
  "recipientAddress": "0xaa91b1C49dB175325aF358bB0E55777cbC4395B6",
  "addressBindTimestamp": "2024-03-25T09:25:47.102Z",
  "addressUnboundTimestamp": "2024-03-25T09:27:06.889Z",
  "transactionHash": "0x04818015418a1e01c838025966cb02535cc540abc098f145d6c2fc70a2d0f8e0",
  "status": "complete",
  "bearer": "MERCHANT",
  "reference": "PLK_fv3vjzdllu6qsndw",
  "transactionReference": "KDX|lu6qt8ak|ne7qv",
  "integratorId": "651298c28a73710b161bda70",
  "userId": "651298c28a73710b161bda6e",
  "metadata": {
    "phone": "+23495858348",
    "fullname": "charles chinonso Ugwoke",
    "email": "ugdesmond@gmail.com",
    "address": "software engineer"
  },
  "__type": "Collections"
```