Get Transaction History

Retrieves the end user’s transaction history.

Endpoint

GET /whitelabel/transactions/getHistory

Request Headers

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
page	String	Yes	Page number according to the pagination
rows	String	Yes	Number of rows per page

Example Request

GET /whitelabel/transactions/getHistory?externalUserId=user-10021

Signed query object:

{
  "endUserId": 20001, // Optional: Provide one user identifier only
  "endUserEmail": "[e-mail]", // Optional: Alternative to endUserId and externalUserId
  "externalUserId": "user-10021", // Optional: Alternative to endUserId and endUserEmail
  "page": '1',
  "rows": '20'
}

Illustrative Filtered Request

GET /whitelabel/transactions/getHistory?externalUserId=user-10021&currency=USDT&status=completed&page=1&limit=20

The exact filter names must follow the deployed transaction-history schema.

Code Snippet

JavaScript (Axios)

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: "[e-mail]", // Optional: Alternative to endUserId and externalUserId
    externalUserId: "user-10021", // Optional: Alternative to endUserId and endUserEmail
    page: '1',
    rows: '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/getHistory?${queryString}`, { headers })
    .then(response => console.log(response.data))
    .catch(error => console.error('Error:', error.response ? error.response.data : error.message));

Example Response

{
    "msg": "",
    "data": [
      {
        "transactionId": 2144884,
        "baseAmount": 5,
        "baseAmountReceived": 5,
        "baseCurrency": "USDT",
        "settledCurrency": "USDT",
        "baseCurrencyImage": "https://assets.tylt.money/holdings-icons/USDT.png",
        "settledCurrencyImage": "https://assets.tylt.money/holdings-icons/USDT.png",
        "settledAmountRequested": 5,
        "settledAmountReceived": 5,
        "settledAmountDebited": null,
        "settledAmountCredited": 5,
        "settledAmountSent": null,
        "network": "TPNK",
        "networkImage": "https://assets.tylt.money/payment_user_assets/userUpload-74-1778065240688",
        "status": "Completed",
        "createdAt": "2026-07-09T09:56:41Z",
        "transactionType": "Internal Payin",
        "ledger": "CR",
        "complianceRequired": 0,
        "compliancePending": 0
      },
    ]
}

Transaction Types

The history may contain:

Type	Description
Deposit	Incoming on-chain crypto transaction
Payout	Outgoing on-chain crypto transaction
Internal transfer sent	Transfer sent to another user under the merchant
Internal transfer received	Transfer received from another user under the merchant
Adjustment	Authorized wallet balance adjustment
Fee	Transaction or network fee entry

---