Skip to main content
GET
/
api
/
payouts
/
crypto
/
bulk
/
{id}
Get bulk crypto payout
curl --request GET \
  --url https://app.sandbox.rio.trade/api/payouts/crypto/bulk/{id} \
  --header 'x-api-key: <api-key>'
{
  "createdAt": "2025-01-04T00:24:28.658Z",
  "userId": "6757546b4c5d19bf3cd7b09c",
  "orderIds": [
    "677880bab7a7c5e821c9f56f",
    "67788100b7a7c5e821c9fc0f",
    "6778811fb7a7c5e821c9fef5"
  ],
  "amount": 15000,
  "crypto": "USDC",
  "payoutAddressId": "65ba521a4b3e1bd9eb6a5107",
  "blockchainAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "country": "MX",
  "status": "awaitingOrders",
  "payoutsSent": [
    {
      "amount": 123,
      "blockchainTxId": "<string>",
      "sentAt": "2025-01-04T12:30:00.000Z"
    }
  ],
  "id": "677890d5d520f9ecb10e9c33"
}

​
Requirements to consume the endpoint.

User approved

The user must be approved in at least one country.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
id
string
required

Id of the bulk crypto payout

Response

OK

​
createdAt
string

The date and time the bulk payout was created.

Example:

"2025-01-04T00:24:28.658Z"

​
userId
string

The unique identifier of the user.

Example:

"6757546b4c5d19bf3cd7b09c"

​
orderIds
string[]

List of order IDs associated with this bulk payout.

Example:
[
  "677880bab7a7c5e821c9f56f",
  "67788100b7a7c5e821c9fc0f",
  "6778811fb7a7c5e821c9fef5"
]
​
amount
number

The total payout amount across all orders.

Example:

15000

​
crypto
enum<string>

The cryptocurrency of the payout.

Available options:
USDC,
USDC_POLYGON,
USDC_POLYGON_NXTB,
SOL_USDC_PTHX,
XLM_USDC_5F3T,
USDT_POLYGON,
USDT_ERC20,
TRX_USDT_S2UZ
​
payoutAddressId
string

The ID of the destination crypto address.

Example:

"65ba521a4b3e1bd9eb6a5107"

​
blockchainAddress
string

The blockchain address where funds will be sent.

Example:

"0x1234567890abcdef1234567890abcdef12345678"

​
country
enum<string>

The country of the operation.

Available options:
MX,
PE
​
status
enum<string>

The current status of the bulk crypto payout.

Available options:
awaitingOrders,
awaitingPaymentForOrders,
awaitingPayoutRequest,
awaitingPayout,
awaitingAsyncPayout,
awaitingAsyncPayoutRequest,
checkingLiquidity,
sourcingLiquidity,
liquiditySourced,
complete,
failed,
cancelled
Example:

"awaitingOrders"

​
payoutsSent
object[]

Details of individual payouts within this bulk payout.

​
id
string

The unique identifier of the bulk crypto payout.

Example:

"677890d5d520f9ecb10e9c33"