Fetch payout

Returns the payout by “payoutId” attribute.

POST https://app.thedex.cloud/api/v1/payouts/one

Headers

Name	Type	Description
X-EX-APIKEY*	String	Your API key
X-EX-PAYLOAD*	String	Body to base64
X-EX-SIGNATURE*	String	Encrypted body with the secret key

Request Body

{
    "payoutId": "String"
}

Request JSON attributes

Name	Type	Description
payoutId*	String	ID of payout to find

Response Body

200 payout

{
   "id": "String",
   "status": "Integer",
   "statusName": "String",
   "fiatCurrency": "String",
   "fiatAmount": "String",
   "payCurrency": "String",
   "address": "String",
   "fromAddress": "String",
   "memo": "Integer",
   "createDate":"String",
   "modifiedDate":"String",
   "transactionId":"String",
   "withdrawalAmount":"String",
   "transferAmount":"String",
   "blockchainFee":"String",
   "payoutCommissionPercentage":"String",
   "isApiCalled":"Boolean",
   "uniqueUserId":"String",
   "description":"String",
   "merchantId":"String",
   "callbackUrl":"String",
   "creationWay":"String"
}

Response JSON attributes

"id"	String	Payout id
"status"	Integer	reach out all accessed values by link: /api/v1/info/statuses
"statusName"	String	reach out all accessed values by link: /api/v1/info/statuses
"fiatCurrency"	String	Fiat currency
"payCurrency"	String	Cryptocurrency
"address"	String	Address is used to widthrawal
"memo"	Integer	Additional destination info
createDate	String	Creation date
"modifiedDate"	String	Modification date
"transactionId"	String	Transaction id
"withdrawalAmount"	String	Withdrawal amount
"transferAmount"	String	Transfer amount
"blockchainFee"	String	Blockchain fee
"payoutCommissionPercentage"	String	Payout commission in percentage
"isApiCalled"	Boolean	Always true for this API
"uniqueUserId"	String	User UUID
"description"	String	Description
"merchantId"	String	Merchant id
"callbackUrl"	String	Callback url
"creationWay"	String	How payout was created (e.g. with "API" , on "UI")
"fiatAmount"	String	Fiat amount of payout
"fromAddress"	String	Address from which payout was made

Request Curl

curl --location --request POST 'https://app.thedex.cloud/api/v1/payouts/one' \
--header 'X-EX-APIKEY: <string>' \
--header 'X-EX-PAYLOAD: <string>' \
--header 'X-EX-SIGNATURE: <string>' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--data '{
  "payoutId": "<string>"
}'

Example Curl

curl --location --request POST 'https://app.thedex.cloud/api/v1/payouts/one' \
--header 'X-EX-APIKEY: abcd1234apikeyexample' \
--header 'X-EX-PAYLOAD: eyJwYXlvdXRJZCI6ICJmZTc1NzI2YS1lYjM1LTQ5ZWYtODJjNi0wOTgxMjM0NTY3ODkifQ==' \
--header 'X-EX-SIGNATURE: 9f3c1ea0b95a4e049a7b2a3c3d8f2c947e2b40d1886f2ab63fbc725d6fa95fbc' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--data '{
  "payoutId": "fe75726a-eb35-49ef-82c6-098123456789"
}'

Possible errors

Response code: 400

General validation error: malformed UUID parameter.

{
    "error": "Bad Request",
    "status": 400,
    "timestamp": "2026-01-16 00:00:00",
    "message": "payoutId: Invalid UUID format",
    "path": "/api/v1/payouts/one"
}

Response code: 401

In case of incorrect signature, api key or payload header

{
    "error": "Unauthorized",
    "status": 401,
    "timestamp": "2026-01-01 00:00:00",
    "message": "Request is not authorized"
}

Response code 500

In case if payout not exist.

{
    "error": "Internal Server Error",
    "status": 500,
    "timestamp": "2026-01-16 04:22:25",
    "message": "Cannot get an payout"
}