> For the complete documentation index, see [llms.txt](https://docs.tylt.money/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tylt.money/tylt-embedded-wallet-service/wallet-management-apis/get-ledger-report.md).

# Get Ledger Report

Generates a ledger-level report showing wallet credits, debits, balances, and related entries.

### Endpoint

```http
GET /whitelabel/transactions/getLedgerReport
```

### Request Headers

```http
x-tlp-apikey: <api-key>
x-tlp-signature: <hmac-signature>
```

### Query Parameters

Provide at least one of the following user identifiers: `endUserEmail`, `endUserId`, or `externalUserId`.

| Field            | Type   |    Required | Description                         |
| ---------------- | ------ | ----------: | ----------------------------------- |
| `endUserEmail`   | String | Conditional | End user’s registered email address |
| `endUserId`      | Number | Conditional | Tylt end-user ID                    |
| `externalUserId` | String | Conditional | Merchant’s own user identifier      |
| `startDate`      | String |         Yes | Starting date filter                |
| `endDate`        | String |         Yes | Ending date filter                  |

### Example Request

```http
GET /whitelabel/transactions/getLedgerReport?externalUserId=user-10021&startDate=2026-07-01&endDate=2026-07-31
```

### Code Snippet

{% tabs %}
{% tab title="JavaScript (Axios)" %}

```javascript
import crypto from 'crypto';
import axios from 'axios';

const apiKey = 'your-api-key';
const apiSecret = 'your-api-secret';

const queryParams = {
    endUserId: 20001, // Optional: Provide one user identifier only
    endUserEmail: "joe@example.com", // Optional: Alternative to endUserId and externalUserId
    externalUserId: "user-10021", // Optional: Alternative to endUserId and endUserEmail
    startDate: '2026-07-01',
    endDate: '2026-07-20'
};

const rawPayload = JSON.stringify(queryParams);
const signature = crypto.createHmac('sha256', apiSecret).update(rawPayload).digest('hex');

const headers = {
    'x-tlp-apikey': apiKey,
    'x-tlp-signature': signature
};

const queryString = new URLSearchParams(queryParams).toString();
axios.get(`https://api.tylt.money/whitelabel/transactions/getLedgerReport?${queryString}`, { headers })
    .then(response => console.log(response.data))
    .catch(error => console.error('Error:', error.response ? error.response.data : error.message));
```

{% endtab %}
{% endtabs %}

### Example Response

```json

  "msg": "",
  "data": [
    {
      "transactionId": 2144884,
      "uniqueInternalID": "7beae3e1-7b7c-11f1-a6bf-42010a2801d1",
      "merchantOrderID": "7beae3e1-7b7c-11f1-a6bf-42010a2801d1",
      "transactionType": "Internal Payin",
      "ledger": "CR",
      "baseAmount": 5,
      "baseAmountReceived": 5,
      "conversionRate": 1,
      "baseCurrency": "USDT",
      "baseCurrencyImage": "https://assets.tylt.money/holdings-icons/USDT.png",
      "settledCurrency": "USDT",
      "settledCurrencyImage": "https://assets.tylt.money/holdings-icons/USDT.png",
      "requestedCurrency": "USDT",
      "settledAmountRequested": 5,
      "settledAmountReceived": 5,
      "settledAmountDebited": 0,
      "settledAmount": 5,
      "commission": 0,
      "network": "TPNK",
      "networkImage": "https://assets.tylt.money/payment_user_assets/userUpload-74-1778065240688",
      "walletAddress": "f95bf002-3a05-4f6f-9613-ac5255c07dd4",
      "toAddress": null,
      "status": "Completed",
      "insufficientBalance": null,
      "isFinal": 1,
      "isCredited": 0,
      "isDebited": null,
      "paymentURL": "",
      "callBackURL": "",
      "redirectURL": "",
      "createdAt": "2026-07-09T09:56:41Z",
      "expiresAt": "2026-07-09T09:56:41Z",
      "updatedAt": "2026-07-09T09:57:01Z",
      "toFrom": "setucuhe@forexzig.com",
      "comments": ""
    },
    {
      "transactionId": 2144823,
      "uniqueInternalID": "3adffe4d-7b7b-11f1-a6bf-42010a2801d1",
      "merchantOrderID": "3adffe4d-7b7b-11f1-a6bf-42010a2801d1",
      "transactionType": "Internal Payout",
      "ledger": "DR",
      "baseAmount": 0.1,
      "baseAmountReceived": 0.1,
      "conversionRate": 1,
      "baseCurrency": "USDT",
      "baseCurrencyImage": "https://assets.tylt.money/holdings-icons/USDT.png",
      "settledCurrency": "USDT",
      "settledCurrencyImage": "https://assets.tylt.money/holdings-icons/USDT.png",
      "requestedCurrency": "USDT",
      "settledAmountRequested": 0.1,
      "settledAmountReceived": 0,
      "settledAmountDebited": 0.1,
      "settledAmount": 0.1,
      "commission": 0,
      "network": "TPNK",
      "networkImage": "https://assets.tylt.money/payment_user_assets/userUpload-74-1778065240688",
      "walletAddress": "f95bf002-3a05-4f6f-9613-ac5255c07dd4",
      "toAddress": null,
      "status": "Completed",
      "insufficientBalance": null,
      "isFinal": 1,
      "isCredited": 0,
      "isDebited": null,
      "paymentURL": "",
      "callBackURL": "",
      "redirectURL": "",
      "createdAt": "2026-07-09T09:47:42Z",
      "expiresAt": "2026-07-09T09:47:42Z",
      "updatedAt": "2026-07-09T09:48:02Z",
      "toFrom": "wluser-1783514871211@example.com",
      "comments": ""
    }
  ]
}
```

The exact response fields must follow the deployed ledger-report schema.

### Transaction History vs. Ledger Report

| Transaction History                  | Ledger Report                                   |
| ------------------------------------ | ----------------------------------------------- |
| Shows business-level transactions    | Shows wallet-accounting entries                 |
| Usually one record per transaction   | May contain multiple entries per transaction    |
| Designed for end-user activity views | Designed for reconciliation and accounting      |
| Includes transaction status          | Includes debit, credit, and balance information |
| Suitable for wallet interfaces       | Suitable for statements and reconciliation      |

***

##