Skip to main content

Transfer details

Returns full information about a single transfer.


HTTP Request

GET /v1/transfers/{id}/

Where:

  • {id} — the transfer ID (UUID)

Response

Returns a REGISTERED_TRANSFER_EXTRA object.

Transfer object (REGISTERED_TRANSFER_EXTRA)

FieldTypeDescription
idstringTransfer UUID.
client_idstring / nullExternal client ID (if provided).
attempt_idstring / nullExternal attempt ID (if provided).
registered_atstring (ISO8601)When the transfer was registered in BitOK.
risk_levelstringAggregated risk level (none, low, medium, high, severe, undefined).
risk_scorenumber / nullNumerical risk score.
networkstringBlockchain network code (e.g. TRX, ETH).
token_idstring / nullToken identifier (native or token contract/address).
token_symbolstring / nullToken symbol.
tx_statusstringTransaction binding status (none, binding, bound, not_found).
tx_hashstring / nullBlockchain transaction hash (if known).
occurred_atstring (ISO8601) / nullOn-chain transaction timestamp.
input_addressstring / nullSender address (for incoming transfers).
output_addressstring / nullRecipient address (for outgoing transfers).
directionstringincoming or outgoing.
amountnumber / nullTransfer amount.
value_in_fiatnumber / nullFiat value in fiat_currency.
check_stateobjectPer-check processing state (see below).
fiat_currencystringFiat currency code (USD).

check_state object

FieldTypeDescription
exposurestringExposure check state (none, queued, checking, checked, error).
exposure_checked_atstring (ISO8601) / nullWhen exposure state was last updated.
counterpartystringCounterparty check state.
counterparty_checked_atstring (ISO8601) / nullWhen counterparty state was last updated.
sanctionsstringSanctions check state/result.
sanctions_checked_atstring (ISO8601) / nullWhen sanctions state was last updated.

Example response

{
"id": "07067ca4-8552-47d3-b73b-61d305ddb8c5",
"client_id": "id0001",
"attempt_id": null,
"registered_at": "2026-01-29T10:09:59.199737+03:00",
"risk_level": "medium",
"risk_score": 0.517604,
"network": "TRX",
"token_id": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"token_symbol": "USDT",
"tx_status": "bound",
"tx_hash": "60389a97a30523c696b904a5faadf93521a4478f2d8dbcef9c519751148b008d",
"occurred_at": "2026-01-23T11:19:36Z",
"input_address": "TYR4w7SWcaWCHHoTvvR5aVWh6y7pa6wgdK",
"output_address": "TCM4UnCxL6p2KHbZeKETirjcDFJDCwhtqs",
"direction": "incoming",
"amount": 348000.0,
"value_in_fiat": 348117.24,
"check_state": {
"exposure": "checked",
"exposure_checked_at": "2026-01-30T10:52:47.486422Z",
"counterparty": "none",
"counterparty_checked_at": null,
"sanctions": "none",
"sanctions_checked_at": null
},
"fiat_currency": "USD"
}

Try it

GET/v1/transfers/{id}/
API KEY ID
API KEY SECRET
Path params
id
HTTP Request
Press "Send Request" to generate HTTP request.
HTTP …
{
// Response will be shown here after the request.
}