> 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/customers.md).

# 👨‍👩‍👦‍👦 Customers

#### All Customers <a href="#all-customers" id="all-customers"></a>

List all the customers associated with your Konnadex account

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

`GET` `https://api.konnadex.com/v1/customers`

List all the transactions associated with your Konnadex account

**Example : NodeJs - Request**

```javascript

var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://api.konnadex.com/v1/customers',
  '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
{
  "message": "Customers retrieved successfully",
  "status": "success",
  "statusCode": 200,
  "data": [
    {
      "id": "bc48cc84-71cc-XXX-8562-XXXXX",
      "walletId": "33cbb77a-35a2-421f-a733-XXXXX",
      "name": "Abdulfatai Suleiman",
      "email": "abdulfataisuleiman@XXXX.com",
      "shippingAddress": null,
      "phone": null,
      "network": "testnet",
      "createdAt": "2022-09-05T22:09:57.119Z",
      "updatedAt": "2022-09-05T22:09:57.119Z",
      "transactions": [
        {
          "id": "XXXXXX-731e-46a2-XXXX-3495b35d99a6",
          "walletId": "XXXXXX-35a2-421f-XXXX-d23149572fd7",
          "reference": "Vuzr458xTg",
          "senderAddress": null,
          "recipientAddress": "0x79A0cd9390384XXXXXXXXX5128d4884094c",
          "actualAmount": 10,
          "amountPaid": 0,
          "amountPaidFiat": 0,
          "fiatAmount": 10,
          "amountReceived": 0,
          "amountReceivedFiat": 0,
          "fee": 0.1,
          "coin": "BUSD",
          "currency": "USD",
          "hash": null,
          "blockNumber": null,
          "type": "received",
          "acceptPartialPayment": false,
          "status": "pending",
          "network": "testnet",
          "paymentChannel": "crypto_transfer",
          "blockchain": "Binance Smart Chain",
          "fiatRate": 1,
          "cryptoRate": 1,
          "metadata": {},
          "fromCoin": null,
          "toCoin": null,
          "createdAt": "2022-09-05T22:09:57.119Z",
          "updatedAt": "2022-09-05T22:09:57.119Z"
        }
      ]
    }
  ],
  "count": 1,
  "currentPage": 1,
  "nextPage": null,
  "prevPage": null,
  "lastPage": 1
}
```

#### Get customers by customer ID <a href="#get-customers-by-customer-id" id="get-customers-by-customer-id"></a>

Fetch a specific customer using its transaction ID

### List customers by customer Id <a href="#list-customers-by-customer-id" id="list-customers-by-customer-id"></a>

`GET` `https://api.konnadex.com/v1/transactions/:customer_id`

**Path Parameters**

<table><thead><tr><th width="143.3333740234375">Name</th><th width="128.33331298828125">Type</th><th>Description</th></tr></thead><tbody><tr><td>:customer_id*</td><td>String</td><td>Supply a customer ID</td></tr></tbody></table>

**Sample Request: Nodejs - request**

```javascript
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://api.konnadex.com/v1/customers/<id>',
  '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);
});
```

```javascript
{
  "message": "Customer retrieved successfully",
  "data": {
    "id": "bc48cc84-XXXX-45e3-XXXX-6b54585ac53e",
    "walletId": "33cbb77a-XXXX-XXXX-a733-d23149572fd7",
    "name": "Abdulfatai Suleiman",
    "email": "abdulfataisuleiman@XXXX.com",
    "shippingAddress": null,
    "phone": null,
    "network": "testnet",
    "createdAt": "2022-09-05T22:09:57.119Z",
    "updatedAt": "2022-09-05T22:09:57.119Z",
    "transactions": [
      {
        "id": "93754962-XXXX-XXXX-9858-3495b35d99a6",
        "walletId": "XXXXXX-35a2-421f-XXXX-d23149572fd7",
        "reference": "Vuzr458xTg",
        "senderAddress": null,
        "recipientAddress": "0x79A0cd9390384E3XXXXXX005128d4884094c",
        "actualAmount": 10,
        "amountPaid": 0,
        "amountPaidFiat": 0,
        "fiatAmount": 10,
        "amountReceived": 0,
        "amountReceivedFiat": 0,
        "fee": 0.1,
        "coin": "BUSD",
        "currency": "USD",
        "hash": null,
        "blockNumber": null,
        "type": "received",
        "acceptPartialPayment": false,
        "status": "pending",
        "network": "testnet",
        "paymentChannel": "crypto_transfer",
        "blockchain": "Binance Smart Chain",
        "fiatRate": 1,
        "cryptoRate": 1,
        "metadata": {},
        "fromCoin": null,
        "toCoin": null,
        "createdAt": "2022-09-05T22:09:57.119Z",
        "updatedAt": "2022-09-05T22:09:57.119Z"
      }
    ]
  },
  "status": "success",
  "statusCode": 200
}
```