Listing payouts

GET /api/public/v1/payouts

This endpoint returns a list of payouts with pagination.

Headers

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

Query Parameters

Name	Type	Description
order	string	Order in which the list of payouts should be returned. Can be created_at.
order_type	string	Order type. Can be either asc or desc.
page	number	Page for which you want to return payouts.
per_page	number	Number of payouts per page to return.
reference	number	Payout reference.

Response Body

Name	Type	Description
data.id	string	Payout ID.
data.type	string	Aways payouts.
data.attributes.reference	string	The custom reference ID to tie the payout to end-user who gets paid. This can be anything you choose.
data.attributes.status	string	Payout status. Refer to Payout Status Flow.
data.attributes.address	string	Wallet address of a payout recipient.
data.attributes.createdAt	string	Payout creation timestamp.
data.attributes.absorbFees	boolean	If false or omitted, both service and network fees are deducted from the transaction amount. If true, both fees are deducted from your account balance.
data.attributes.amount	number	Payout amount. This is the amount that Txn debited from your account on the Txn platform.
data.attributes.currency	string	Payout amount currency code. This is effectively the currency account which Txn took the payout amount from.
data.attributes.payCurrency	string	The code of a token or cryptocurrency transferred to the receiving address.
data.attributes.payAmount	string	The amount of tokens or cryptocurrency transferred to the receiving address.
data.attributes.txid	string	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.
data.attributes.payNetwork	string	Refer to Supported Currencies.
data.attributes.networkName	string	Network name. E.g. Tron (TRC20).
data.attributes.networkFee	string	The network fee amount Txn took to cover blockchain fees.
data.attributes.networkFeeCurrency	string	Network fee currency.
data.attributes.payoutFee	string	Payout fee amount. This is the Txn's processing fee.
data.attributes.payoutFeeCurrency	string	Payout fee currency.
data.attributes.exchangeRate	string	Exchange rate.

Response

HTTP 200

{
  "data": [
    {
      "id": "dfa4b8dc-6b7c-481a-b486-71f6db5126fc",
      "type": "payouts",
      "attributes": {
        "address": "TTbGTMwUwA3mncLP7xqCZei1ekaNSgeAJe",
        "createdAt": "2024-07-30T15:35:40.253Z",
        "absorbFees": false,
        "reference": "44650aff-f7dd-49e5-ad59-01e667112a31",
        "status": "processing",
        "amount": "50.00",
        "currency": "USD",
        "payCurrency": "USDT",
        "payAmount": "45.020195",
        "payNetwork": "ttrx:usdt",
        "payNetworkName": "Tron (TRC20)",
        "txid": null,
        "networkFee": "4.000000",
        "networkFeeCurrency": "USDT",
        "payoutFee": "0.50",
        "payoutFeeCurrency": "USD",
        "exchangeRate": "1.0097879"
      }
    },
    {
      "id": "c03bc7ec-8cf8-449c-9ba5-660364970682",
      "type": "payouts",
      "attributes": {
        "address": "TTbGTMwUwA3mncLP7xqCZei1ekaNSgeAJe",
        "createdAt": "2024-07-30T15:32:15.287Z",
        "absorbFees": false,
        "reference": "e8fd9254-dba4-448e-a537-4a670d720855",
        "status": "completed",
        "amount": "50.00",
        "currency": "USD",
        "payCurrency": "TRX",
        "payAmount": "363.663665",
        "payNetwork": "ttrx",
        "payNetworkName": "Tron",
        "txid": "b4ad13397e401b1238b73f5e9d99d507504096f5638e1c72cd35568f61a7139b",
        "networkFee": "2.000000",
        "networkFeeCurrency": "TRX",
        "payoutFee": "0.50",
        "payoutFeeCurrency": "USD",
        "exchangeRate": "0.1353703"
      }
    }
  ],
  "meta": {
    "page": "1",
    "per_page": "2",
    "total": 20
  },
  "jsonapi": {
    "version": "1.0"
  }
}