List Payouts

curl "https://sandbox-api.tender.cash/v1/api/payout?page=1&limit=10" \
  -H "x-access-id: your-access-id-here" \
  -H "x-request-id: 550e8400-e29b-41d4-a716-446655440000" \
  -H "x-timestamp: 2026-10-15T09:45:53.000Z" \
  -H "authorization: <signature>"

{
  "status": "success",
  "message": "success",
  "data": {
    "data": [
      {
        "_id": "66aec7de809b7f45c42a49f9",
        "type": "crypto",
        "status": "completed",
        "coin": "usdt",
        "chain": "tron",
        "amount": "49.5",
        "totalAmount": "50",
        "usdValue": "49.5",
        "totalAmountUSD": "50",
        "fee": "0.5",
        "feeUSD": "0.5",
        "address": "TQn9Y2khDD9JHTfVE5oB2h8BKWWM4LxKLT",
        "txId": "7c1f0a9d3e5b...",
        "chainId": { "id": "tron", "name": "Tron", "chainType": "tron" },
        "currency": { "id": "usdt", "name": "Tether USD", "symbol": "USDT" },
        "createdAt": "2026-10-15T09:20:15.650Z",
        "updatedAt": "2026-10-15T09:22:41.003Z"
      }
    ],
    "total": 1,
    "pages": 1,
    "page": 1,
    "limit": 10
  }
}

GET

api

payout

curl "https://sandbox-api.tender.cash/v1/api/payout?page=1&limit=10" \
  -H "x-access-id: your-access-id-here" \
  -H "x-request-id: 550e8400-e29b-41d4-a716-446655440000" \
  -H "x-timestamp: 2026-10-15T09:45:53.000Z" \
  -H "authorization: <signature>"

{
  "status": "success",
  "message": "success",
  "data": {
    "data": [
      {
        "_id": "66aec7de809b7f45c42a49f9",
        "type": "crypto",
        "status": "completed",
        "coin": "usdt",
        "chain": "tron",
        "amount": "49.5",
        "totalAmount": "50",
        "usdValue": "49.5",
        "totalAmountUSD": "50",
        "fee": "0.5",
        "feeUSD": "0.5",
        "address": "TQn9Y2khDD9JHTfVE5oB2h8BKWWM4LxKLT",
        "txId": "7c1f0a9d3e5b...",
        "chainId": { "id": "tron", "name": "Tron", "chainType": "tron" },
        "currency": { "id": "usdt", "name": "Tether USD", "symbol": "USDT" },
        "createdAt": "2026-10-15T09:20:15.650Z",
        "updatedAt": "2026-10-15T09:22:41.003Z"
      }
    ],
    "total": 1,
    "pages": 1,
    "page": 1,
    "limit": 10
  }
}

Auth method: Signed (HMAC) — this endpoint requires the full set of signed headers: x-access-id, x-request-id, x-timestamp, and an HMAC-SHA256 authorization signature. See Authentication.

All payout endpoints, including this one, share a bucket of 10 requests per minute per merchant, on top of the general limit. See Rate limits.

Headers

string

required

Base64-encoded HMAC-SHA256 signature of {"timeStamp":"<x-timestamp>","requestId":"<x-request-id>","accessId":"<x-access-id>"}, signed with your access secret. The request body is not part of the signature.Example: "pV3n0o8kq0lK2mJ8bZ1yq3Yt6hR0cXK9u4mVJ2l9sE0="

string

required

ISO 8601 timestamp; must be within 5 minutes of server timeExample: "2026-10-15T09:45:53.000Z"

string

required

A unique UUID v4 per requestExample: "550e8400-e29b-41d4-a716-446655440000"

string

required

Your API access ID provided by TenderExample: "your-access-id-here"

Query parameters

number

default:"1"

Page number, starting at 1Example: 1

number

default:"10"

Number of records per pageExample: 10

Response

string

required

success on successExample: "success"

string

required

Human-readable result messageExample: "success"

object

required

Paginated payouts, most recently updated first

Show data properties

array

Array of payout objects

Show payout object

string

Payout IDExample: "66aec7de809b7f45c42a49f9"

string

crypto or fiatExample: "crypto"

string

pending (queued), processing (handed to the network or payout provider), completed or failedExample: "completed"

string

Coin paid outExample: "usdt"

string

Chain the payout is sent fromExample: "tron"

string

For crypto payouts, the net amount the recipient receives (requested amount minus the fee). For fiat payouts, the requested amount.Example: "49.5"

string

The amount you requested, which is what is debited from your balanceExample: "50"

string

USD value of amountExample: "49.5"

string

USD value of totalAmountExample: "50"

string

Payout fee in coin (crypto payouts)Example: "0.5"

string

Payout fee in USD (crypto payouts)Example: "0.5"

string

Destination wallet address (crypto payouts)Example: "TQn9Y2khDD9JHTfVE5oB2h8BKWWM4LxKLT"

string

Saved payout account used, if any

string

On-chain transaction hash, once the payout has been broadcastExample: "7c1f0a9d3e5b..."

string

Recipient bank name (bank payouts)Example: "KUDA MICROFINANCE BANK"

string

Recipient bank code (bank payouts)Example: "090267"

string

Recipient account number (bank payouts)Example: "0123456789"

string

Recipient account name, when known (bank payouts)

string

The reference you sent with a fiat payoutExample: "user-8821"

string | null

MoneyGram transaction ID (MoneyGram payouts only)Example: "abc123"

string | null

Raw status last reported by MoneyGram, for example pending_user_transfer_start or completed (MoneyGram payouts only)Example: "pending_anchor"

string

ISO 8601 timestampExample: "2026-10-15T09:20:15.650Z"

string

ISO 8601 timestampExample: "2026-10-15T09:22:41.003Z"

object

The chain record, with id, name, icon and chainTypeExample: { "id": "tron", "name": "Tron", "chainType": "tron" }

object

The coin record, with id, name, symbol and iconExample: { "id": "usdt", "name": "Tether USD", "symbol": "USDT" }

number

Total number of payoutsExample: 23

number

Total number of pagesExample: 3

number

Current pageExample: 1

number

Items per pageExample: 10

Additional fields may be present; ignore fields you don’t recognise.

curl "https://sandbox-api.tender.cash/v1/api/payout?page=1&limit=10" \
  -H "x-access-id: your-access-id-here" \
  -H "x-request-id: 550e8400-e29b-41d4-a716-446655440000" \
  -H "x-timestamp: 2026-10-15T09:45:53.000Z" \
  -H "authorization: <signature>"

{
  "status": "success",
  "message": "success",
  "data": {
    "data": [
      {
        "_id": "66aec7de809b7f45c42a49f9",
        "type": "crypto",
        "status": "completed",
        "coin": "usdt",
        "chain": "tron",
        "amount": "49.5",
        "totalAmount": "50",
        "usdValue": "49.5",
        "totalAmountUSD": "50",
        "fee": "0.5",
        "feeUSD": "0.5",
        "address": "TQn9Y2khDD9JHTfVE5oB2h8BKWWM4LxKLT",
        "txId": "7c1f0a9d3e5b...",
        "chainId": { "id": "tron", "name": "Tron", "chainType": "tron" },
        "currency": { "id": "usdt", "name": "Tether USD", "symbol": "USDT" },
        "createdAt": "2026-10-15T09:20:15.650Z",
        "updatedAt": "2026-10-15T09:22:41.003Z"
      }
    ],
    "total": 1,
    "pages": 1,
    "page": 1,
    "limit": 10
  }
}

Authorizations

authorization

string

header

required

Signed (HMAC) authentication. Required headers: x-access-id, x-request-id (UUID v4), x-timestamp (ISO 8601, must be within 5 minutes of server time), and authorization: the Base64 HMAC-SHA256 of the JSON string {"timeStamp":"","requestId":"","accessId":""} (keys in that order, no whitespace) using your access secret. The request body, method and path are not signed. The API key must be linked to an outlet.

Headers

authorization

string

required

x-timestamp

string<date-time>

required

ISO 8601 timestamp; must be within 5 minutes of server time

x-request-id

string<uuid>

required

A unique UUID v4 per request

x-access-id

string

required

Query Parameters

page

integer

default:1

Page number (default 1)

Required range: x >= 1

limit

integer

default:10

Records per page (default 10)

Required range: x >= 1

Response

Paginated payouts

status

string

required

Example:

"success"

message

string

required

Example:

"success"

data

object

required

Show child attributes

Payment

Transactions

System

Agents

Conversions

Payouts

Subwallets

Webhooks

On-ramp

Headers

Query parameters

Response

Authorizations

Headers

Query Parameters

Response

​Headers

​Query parameters

​Response

Authorizations

Headers

Query Parameters

Response

Headers

Query parameters

Response