1. Fiat APIs
AIO Docs
EN
  • EN
  • ZH
  • Overview
  • Create API Key
  • Callback
  • Security
  • Pay-in
  • Fiat Pay-in
  • Pay-out
  • API
    • Before You Begin
    • Fiat APIs
      • Fiat Pay-in Overview
      • Create KYC
        POST
      • List KYC
        GET
      • Supported Fiat Currencies
        GET
      • Crypto Map
        GET
      • Payment Methods/Codes
        GET
      • Fiat Deposit Limits
        GET
      • Fiat Pay-in Quote
        POST
      • Create Fiat Pay-in Order
        POST
      • List Fiat Pay-in Orders
        GET
    • Get Txs
      GET
    • Get Sub Txs
      GET
    • Get Tx Info
      GET
    • Create Payin Tx
      POST
    • Create Payin Longtime Tx
      POST
    • Create Payout Tx
      POST
    • Price
      GET
    • Calculate price
      GET
  • Schemas
    • Schemas
      • CallbackReqContentData
      • CallbackSubTxData
      • CallbackTxData
      • CallbackType
      • GetSubTxData
      • SubTxDataExt
      • SubTxStatus
      • GetSubTxDataResponse
      • CreateFiatKycRequest
      • CreateFiatKycResponse
      • Chain
      • ErrorResponseModel
      • PayTxData
      • PayTxStatusData
      • PayinLongTimeTxParams
      • PayinTxParams
      • PayoutSubTxParams
      • PayoutTxParams
      • PriceData
      • RedisKeyData
      • SubTxData
      • SuceedResponseModel
      • TestData
      • Token
      • TxData
      • TxDetailsData
      • TxStatus
      • TxType
      • VsToken
      • TestDataResponse
      • RedisKeyDataResponse
      • PriceDataResponse
      • PayTxDataResponse
      • PayTxStatusDataResponse
      • TxDetailsDataResponse
      • TxDataResponse
  1. Fiat APIs

List Fiat Pay-in Orders

Developing
GET
/v2/fiat/pay-in

What This API Does#

Returns fiat pay-in orders with pagination and optional filters.

Query Parameters#

FieldTypeRequired / NullableConditions / Notes
searchstringOptional, can be omittedSearch by fiat_order_id or txid.
fiat_order_idstringOptional, can be omittedFilter by fiat order ID.
txidstringOptional, can be omittedFilter by AIO transaction ID.
chainstringOptional, can be omittedFilter by chain.
tokenstringOptional, can be omittedFilter by token.
statusstringOptional, can be omittedFilter by fiat order status.
fiat_kyc_idstringOptional, can be omittedFilter by KYC ID.
fiat_currencystringOptional, can be omittedFilter by fiat currency.
pageintegerOptional, can be omittedPage number. Range: 1 to 9999. Default: 1.
sizeintegerOptional, can be omittedPage size. Range: 10 to 50. Default: 10.

Response Structure#

{
  "page": 1,
  "size": 10,
  "total": 1,
  "max_page": 1,
  "data": [
    {
      "fiat_order_id": "OR-xxxx",
      "txid": "Ixxxxxxxxxxxxxxxxxxxx",
      "status": "initiated",
      "fiat_currency": "USD",
      "fiat_amount": "101.23",
      "fiat_payment_url": "https://...",
      "token": "USDT",
      "token_amount": "100",
      "chain": "Ethereum",
      "bind_info": "order=123",
      "created_at": "2026-01-15T09:00:00",
      "modified_at": "2026-01-15T09:00:00"
    }
  ]
}

Logic in a Nutshell#

Use this endpoint for reconciliation, support, and order status lookup. You can search by txid, fiat_order_id, KYC profile, currency, token, chain, or status.

Request

None

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.aio.cash/v2/v2/fiat/pay-in'
Response Response Example
{
    "success": true,
    "msg": "ok",
    "data": {}
}
Modified at 2026-05-18 08:39:10
Previous
Create Fiat Pay-in Order
Next
Get Txs
Built with