GET
/
api
/
orders
/
{id}
curl --request GET \
  --url https://app.sandbox.rio.trade/api/orders/{id} \
  --header 'x-api-key: <api-key>'
{
  "fees": {
    "processingFeeFiat": 0,
    "transferFeeFiat": 0.17584797034499297,
    "brokerFeeFiat": 0,
    "brokerFeeFiatTax": 0,
    "platformFeeFiat": 20,
    "platformFeeFiatTax": 3.2
  },
  "destinationOfFunds": {
    "blockchainAddress": "TS9kqAVq4PR7xNoQDJXSP6Kgz8GFbwUbzi",
    "accountHolderName": "John Doe",
    "accountNumber": "1234567890",
    "CCI": "00111233001112345678",
    "CLABE": "014027000000000008"
  },
  "quoteId": "6660be85d6c964829d63fd05",
  "userId": "65a99abb6a92bda6e52bf7af",
  "status": "created",
  "crypto": "USDC",
  "side": "buy",
  "fiat": "USD",
  "createdAt": "2024-06-05T19:38:20.264Z",
  "country": "MX",
  "amountFiat": 1000,
  "amountCrypto": 55.54,
  "price": 0.0568673040717,
  "netPrice": 0.05554,
  "notes": "Description Pt.1",
  "payoutBankAccountId": "660c10c6eb4fbb235708b8e8",
  "expiredQuotes": [],
  "USBankTransferMethod": "ach_push",
  "cryptoAddress": "0xAf56edF88c429F1D6858f9E47731FF53F6d34D0C",
  "depositAddress": "0xAf56edF88c429F1D6858f9E47731FF53F6d34D0C",
  "amountFiatReceived": 1000,
  "withdrawalTxId": "0x66ECBd38905CC32249ddd6f4f0B4A3DdDDCbd608",
  "withdrawalTxIds": [
    "<string>"
  ],
  "id": "67811d310936d148349f5676",
  "payoutAddressId": "673b5cf6302b8444c78dd3d3",
  "attributes": [
    "fixedPrice"
  ],
  "payoutTransferLimit": 475000,
  "version": 0,
  "paymentsReceived": [
    {
      "amount": 100000,
      "accountHolderName": "John Doe",
      "accountNumber": "<string>",
      "CCI": "<string>",
      "CLABE": "<string>",
      "receivedAt": "2025-01-10T13:14:42.855Z",
      "blockchainAddress": "<string>",
      "blockchainTxId": "<string>"
    }
  ],
  "payoutsSent": [
    {
      "amount": 4748.36,
      "blockchainTxId": "0x66ECBd38905CC32249ddd6f4f0B4A3DdDDCbd608",
      "sentAt": "2025-01-10T13:14:48.240Z",
      "SPEITrackingNumber": "<string>",
      "CEPLink": "<string>",
      "reference": "<string>"
    }
  ],
  "paymentInstructions": {
    "bankName": "NVIO",
    "companyName": "RAMPA BLOCKCHAIN SAPI DE CV",
    "companyAddress": "Ave. Lázaro Cardenas 2400, Residencial San Agustin 1 Sector, San Pedro Garza Garcia, CP 66260, Mexico",
    "reference": "9f5676",
    "CLABE": "710969000021237966",
    "RFC": "RBL2206107N8",
    "blockchainAddress": "0xAf56edF88c429F1D6858f9E47731FF53F6d34D0C"
  },
  "paymentReceivedAt": "2025-01-10T13:14:42.855Z",
  "invoice": {
    "PDFLink": "<string>",
    "XMLLink": "<string>"
  }
}

​
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 order to be obtained.

Response

200
application/json
OK
​
fees
object

Object containing detailed information about various fees

​
destinationOfFunds
object

Details about the destination of funds

​
quoteId
string

The unique identifier of the quote

​
userId
string

The unique identifier of the user

​
status
enum<string>

The current status of the order

Available options:
created,
cancelled,
processing,
sourcingLiquidity,
cryptoAddressAdded,
liquiditySourced,
awaitingBankPayoutDetails,
awaitingBinanceSettlement,
binanceSettlementFailed,
incorrectBinanceSettlement,
depositRegistered,
depositConfirmed,
paymentOriginMismatch,
paid,
filled,
refundInitiated,
addressCheckPassed,
depositAddressCreated,
complete,
failedPayment,
bankPayoutDetailsAdded,
awaitingPayment,
awaitingOriginOrderCompletion,
awaitingTransferReissue,
awaitingPayout,
awaitingAsyncPayout,
awaitingAsyncPayment,
awaitingBridgeRouting,
failedFill,
failedTransfer,
failedQuote,
failedProcessorRouting,
failedLiquidityRouting,
failedFees,
incorrectAmountPaid,
insufficientLiquidityFailed,
depositAddressFailed,
addressCheckFailed,
refundFailed,
refundComplete,
bridgeOrderCreationFailed,
bridgeOrderRoutingFailed,
bridgeTransferFailed,
depositAmountMismatchFailed,
failedUnknown,
expired
​
crypto
enum<string>

The type of cryptocurrency involved in the order

Available options:
USDC,
USDC_POLYGON_NXTB,
SOL_USDC_PTHX,
USDT_POLYGON,
USDT_ERC20,
TRX_USDT_S2UZ
​
side
enum<string>

The side of the order

Available options:
buy,
sell
​
fiat
enum<string>

The type of fiat currency used

Available options:
USD,
MXN,
PEN
​
createdAt
string

The date and time the order was created

​
country
enum<string>

The country of the user

Available options:
MX,
PE,
US
​
amountFiat
number

The amount in fiat currency

​
amountCrypto
number

The amount in cryptocurrency

​
price
number

The price of the cryptocurrency

​
netPrice
number

The net price of the cryptocurrency

​
notes
string

Any additional notes

​
payoutBankAccountId
string

The unique identifier of the bank account to which the payout will be sent

​
expiredQuotes
string[]

List of expired quotes

​
USBankTransferMethod
enum<string>

Indicates bank transfer method, applies only to the United States.

Available options:
ach_push,
wire
​
cryptoAddress
string

The address of the cryptocurrency

​
depositAddress
string

The deposit address

​
amountFiatReceived
number

The amount of fiat received

​
withdrawalTxId
string

The unique identifier for the withdrawal transaction on the blockchain

​
withdrawalTxIds
string[]

List of unique identifiers of withdrawal transactions on the blockchain.

​
id
string

The ID of the order

​
payoutAddressId
string

The unique identifier of the payout address

​
attributes
string[]

List of attributes associated with the order

​
payoutTransferLimit
number

The limit for payout transfer

​
version
number

The version of the order

​
paymentsReceived
object[]

Information of any payments that were received by Rio for the order

​
payoutsSent
object[]

Information of any payouts that were made by Rio for the order

​
paymentInstructions
object

Account information for the bank to which funds will be sent to in a buy order or the blockchain address the funds will be sent to in a sell order

​
paymentReceivedAt
string

The date and time the payment was received

​
invoice
object

order invoice details, only applies to Mexican orders.

Export orders as csvUpdate order