Get sponsored transfer
Returns a single sponsored transfer by id, including its current status, the fee breakdown, and, once broadcast, its tx_hash and confirmations. On a failed transfer, failure_code and failure_reason explain why. Status lifecycle: quoted, then validating, then submitted, then a chain-specific onboarding step (EVM returns assembled; a first-time Tron sender passes through tron_activating and/or tron_approving while Bitnob activates the account and broadcasts the one-time approval), then pending, then completed. Terminal failure states are failed, expired, and cancelled.
Authorizations
Headers
API version (defaults to the latest supported version if omitted).
v1 Path Parameters
Sponsored-transfer ID
Response
Success
RFC 3339 quote expiry; present while status is quoted. Sign and submit before this time.
Machine-readable failure reason on a failed transfer, e.g. insufficient_token_balance, transfer_reverts, reverted.
Human-readable failure detail.
Bitnob sponsorship fee, charged in the transferred token.
Transfer id; use it in the submit and get endpoints.
Object type discriminator; always "sponsored_transfer".
"sponsored_transfer"
Your markup breakdown; present only if you attached partner_fee on the quote.
What the recipient receives (decimal).
"10.50"
The resolved EVM router contract version the transfer was quoted against (absent for non-EVM).
What the end-user must sign; present only while status is quoted.
Lifecycle status: quoted, validating, submitted, assembled (EVM only), tron_activating and tron_approving (Tron first-time onboarding), pending, completed, failed, expired, cancelled.
"quoted"
What leaves the sender (decimal). In gross mode this equals amount; otherwise it equals recipient_amount + fee + partner_fee.
"10.72"
Whether the request amount was treated as the sender's total debit.
On-chain transaction hash, set once broadcast.