# Reading payout

<mark style="color:green;">`GET`</mark> `/api/public/v1/payouts/:id`

This endpoint returns details of a particular payout by its ID.

**Headers**

| Name          | Value                      |
| ------------- | -------------------------- |
| Content-Type  | `application/vnd.api+json` |
| Authorization | `Bearer <api_key>`         |

**Path Parameters**

| Name | Value      |
| ---- | ---------- |
| id   | Payout ID. |

**Response Body**

<table><thead><tr><th>Name</th><th width="96">Type</th><th>Description</th></tr></thead><tbody><tr><td>data.id</td><td>string</td><td>Payout ID.</td></tr><tr><td>data.type</td><td>string</td><td>Aways <code>payouts</code>.</td></tr><tr><td>data.attributes.reference</td><td>string</td><td>The custom reference ID to tie the payout to end-user who gets paid. This can be anything you choose.</td></tr><tr><td>data.attributes.status</td><td>string</td><td>Payout status. Refer to <a href="payout-status-flow">Payout Status Flow</a>.</td></tr><tr><td>data.attributes.address</td><td>string</td><td>Wallet address of a payout recipient.</td></tr><tr><td>data.attributes.createdAt</td><td>string</td><td>Payout creation timestamp.</td></tr><tr><td>data.attributes.absorbFees</td><td>boolean</td><td>This parameter is deprecated. Use both <code>absorbPayoutFees</code> and <code>absorbNetworkFee</code> instead.</td></tr><tr><td>data.attributes.absorbPayoutFee</td><td>boolean</td><td>If false, the payout  fee is deducted from the transaction amount. If true, the payout fee is deducted from the merchant account balance.</td></tr><tr><td>data.attributes.absorbNetworkFee</td><td>boolean</td><td>If false, the network  fee is deducted from the transaction amount. If true, the network fee is deducted from the merchant account balance.</td></tr><tr><td>data.attributes.amount</td><td>number</td><td>Payout amount.</td></tr><tr><td>data.attributes.currency</td><td>string</td><td>Payout amount currency code.</td></tr><tr><td>data.attributes.payCurrency</td><td>string</td><td>The code of a token or cryptocurrency transferred to the receiving address.</td></tr><tr><td>data.attributes.payAmount</td><td>string</td><td>The amount of tokens or cryptocurrency transferred to the receiving address.</td></tr><tr><td>data.attributes.txid</td><td>string</td><td>The token or cryptocurrency transaction hash. This is effectively a unique identifier of a transaction on a relevant blockchain. You can share it with the receipient as a proof of payment.</td></tr><tr><td>data.attributes.payNetwork</td><td>string</td><td>Refer to <a href="../api-basics/supported-currencies">Supported Currencies</a>.</td></tr><tr><td>data.attributes.payNetworkName</td><td>string</td><td>Network name. E.g. Tron (TRC20).</td></tr><tr><td>data.attributes.networkFee</td><td>string</td><td>Network fee amount.</td></tr><tr><td>data.attributes.networkFeeCurrency</td><td>string</td><td>Network fee currency.</td></tr><tr><td>data.attributes.payoutFee</td><td>string</td><td>Payout fee amount.</td></tr><tr><td>data.attributes.payoutFeeCurrency</td><td>string</td><td>Payout fee currency.</td></tr><tr><td>data.attributes.displayFee</td><td>string</td><td>Fee associated with the payout represented in data.attributes.currency. For example, if the payout currency is TRY, the fee is also expressed in TRY.</td></tr><tr><td>data.attributes.displayFeeCurrency</td><td>string</td><td>Fee associated with the payout represented in data.attributes.currency. For example, if the payout currency is TRY, the fee is also expressed in TRY.</td></tr><tr><td>data.attributes.amountCharged</td><td>string</td><td>The amount deducted from the merchant's account.</td></tr><tr><td>data.attributes.amountChargedCurrency</td><td>string</td><td>The amount deducted from the merchant's account.</td></tr><tr><td>data.attributes.payChargeRate</td><td>string</td><td>Pay currency to charge currency exchange rate applied by Txn. E.g., XRP/EUR.</td></tr><tr><td>data.attributes.payChargeRateCurrency</td><td>string</td><td>Pay currency to charge currency exchange rate applied by Txn.</td></tr><tr><td>data.attributes.exchangeRate</td><td>string</td><td>Pay currency to currency exchange rate applied by Txn. E.g., XRP/TRY.</td></tr><tr><td>data.attibutes.paymentMethod</td><td>string</td><td>Payment method used for the payout.</td></tr><tr><td>data.attibutes.receiverBinanceId</td><td>string</td><td>Recipient's Binance ID.</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="HTTP 200" %}

```json
{
  "data": {
    "id": "e2be6c3c-75cc-4006-983a-afd4e83c7a4b",
    "type": "payouts",
    "attributes": {
      "address": "TTbGTMwUwA3mncLP7xqCZei1ekaNSgeAJe",
      "expiresAt": "2025-07-14T17:31:26.088Z",
      "createdAt": "2025-07-14T17:30:56.088Z",
      "absorbFees": null,
      "absorbPayoutFee": true,
      "absorbNetworkFee": false,
      "paymentMethod": "on_chain",
      "receiverBinanceId": "",
      "reference": "70327e5f-9a3e-4720-b2e4-e899fcbbb956",
      "status": "completed",
      "amount": "1000.00",
      "currency": "TRY",
      "payCurrency": "USDT",
      "payAmount": "22.608351",
      "payNetwork": "ttrx:usdt",
      "payNetworkName": "Tron (TRC20)",
      "txid": "632f5a2803e208f10cd21a780e2ab711e5c6d163d02ec9e578d0dccaf44f5a1c",
      "networkFee": "2.000000",
      "networkFeeCurrency": "USDT",
      "payoutFee": "0.22",
      "payoutFeeCurrency": "EUR",
      "displayFee": "10.00",
      "displayFeeCurrency": "TRY",
      "exchangeRate": "40.636611347206",
      "amountCharged": "21.77",
      "amountChargedCurrency": "EUR",
      "payChargeRate": "0.8755286",
      "payChargeRateCurrency": "EUR"
    },
    "relationships": {
      "accountCharged": {
        "data": {
          "type": "accounts",
          "id": "13a85b45-8543-41c7-b963-394d4ea128ae"
        }
      },
      {
      "author": {
        "data": {
          "type": "apiKeys",
          "id": "45550837-2dc6-4652-9cbf-bfbe4e16382e"
        }
      }
    }
  },
  "included": [
    {
      "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
      "type": "accounts",
      "attributes": {
        "master": true,
        "currencyCode": "EUR",
        "label": "master",
        "bankReference": "BDR6421088115176062",
        "balance": "38445.76",
        "totalBalance": "38667.80",
        "currencyType": "fiat"
      },
      "relationships": {
        "company": {
          "meta": {
            "included": false
          }
        },
        "networks": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "45550837-2dc6-4652-9cbf-bfbe4e16382e",
      "type": "apiKeys",
      "attributes": {
        "name": "Test Key",
        "createdAt": "2024-07-04T16:04:48.187Z"
      }
    }
  ],
  "meta": {},
  "jsonapi": {
    "version": "1.0"
  }
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.txn.io/payouts/reading-payout.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.