> 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-transaction-details.md).

# Get Transaction Details

Retrieves detailed information about a specific transaction.

### Endpoint

```http
GET /whitelabel/transactions/getDetails
```

### 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      |
| `transactionid`  | Number |         Yes | The transaction's identifier        |

### Example Request

```http
GET /whitelabel/transactions/getDetails?externalUserId=user-10021&transactionId=98765
```

Signed query object:

```json
{
  "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
  "transactionId": 98765
}
```

### 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
    transactionId: '2144884'
};

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/getDetails?${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,
    "transactions": [
      {
        "amount": 5,
        "createdAt": "2026-07-09T09:56:41Z",
        "toAddress": "72a056e3-adcc-471b-8fbc-de79b338b381",
        "updatedAt": "2026-07-09T09:56:41Z",
        "blockNumber": 0,
        "fromAddress": "f95bf002-3a05-4f6f-9613-ac5255c07dd4",
        "confirmations": 1,
        "transactionHash": "7c4ccf19-7b7c-11f1-a6bf-42010a2801d1",
        "confirmationStatus": 1,
        "requiredConfirmations": 1
      }
    ],
    "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": ""
  }
}
```

The exact response fields vary by transaction type.

### Transaction Ownership

Tylt scopes the request by the resolved end user.

A merchant cannot retrieve a transaction that belongs to:

* Another end user
* Another merchant
* An unrelated Tylt wallet account

***

##