INinfini
Fund

List withdrawal statuses

Changed on

Returns withdrawals owned by the authenticated merchant whose creation times fall within the inclusive Unix-second range. Requires fund.withdraw permission.

Results are ordered by created_at descending. page defaults to 1 and page_size defaults to 20 with a maximum of 100. A range with no matching withdrawals returns HTTP 200 with an empty withdrawals array. Invalid time ranges or pagination values return HTTP 400.

post/withdraw/status/batch

Request

Headers

X-API-Key-IDstring required

32-character Base58 credential ID returned after public-key registration.

X-API-Timestampstring required

Unix timestamp in seconds; tolerance is ±300 seconds.

X-API-Noncestring required

16 cryptographically random bytes encoded as unpadded Base64URL; fresh on every attempt.

Digeststring required

SHA-256= followed by standard padded Base64 of SHA-256 of exact request body bytes. Required even for an empty body; included in the signing string.

Authorizationstring required

Use Ed25519 signature="BASE64_SIGNATURE", where BASE64_SIGNATURE is the standard padded Base64 signature. See /docs/en/4-authorization for the exact signing string.

Request body

start_timeinteger required

Inclusive withdrawal creation start time, as a Unix timestamp in seconds.

end_timeinteger required

Inclusive withdrawal creation end time, as a Unix timestamp in seconds. Must be greater than or equal to start_time.

pageinteger

Page number.

page_sizeinteger

Number of withdrawals per page.

Example request

{
  "start_time": 1787500000,
  "end_time": 1787599999,
  "page": 1,
  "page_size": 20
}

Response

Standard response envelope with paginated withdrawal statuses

OR

Example response

{
  "data": {
    "withdrawals": [
      {
        "request_id": "e94b4e88-36c2-4550-907e-839742cf5fae",
        "created_at": 1787564636,
        "status": "completed",
        "amount": "11",
        "fee": "0.1",
        "actual_amount": "10.9",
        "transaction_hash": "0xabc123",
        "chain": "ETHEREUM",
        "token_type": "USDT",
        "source_currency": "USDT",
        "gas_fee": "0.1",
        "gas_fee_currency": "USDT",
        "fx_fee": "0",
        "fx_fee_currency": "USDT",
        "fee_paid_by": "BENEFICIARY"
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20,
    "total_pages": 1
  }
}

Changes

  • b9ee797f5199Revision changes
    • breaking

      added the new required header request parameter X-API-Key-ID

    • breaking

      added the new required header request parameter X-API-Nonce

    • breaking

      added the new required header request parameter X-API-Timestamp

    • breaking

      the header request parameter Authorization became required

    • breaking

      the header request parameter Digest became required

    • breaking

      removed the media type application/json for the response with the status

    • breaking

      removed the media type application/json for the response with the status

    • warning

      deleted the header request parameter Date

  • e4576a9f0506Revision changes
    • info

      endpoint added