Orders
Get Orders By Id
GET
header
AuthorizationBearer <token>Scope: orders:read
id*stringThe order with its processing timeline.
application/json- response
A single order with its processing timeline and (for deposit/withdrawal) the external transaction hash.
id*stringOrder ID (prefix ord_).
type*stringDerived order type.
Value in
"deposit""withdrawal""exchange""transfer""pool_deposit""pool_withdrawal""pool_exchange"status*stringValue in
"pending""processing""completed""canceled"source_origin?stringtarget_destination?stringsource_origin_details?Snapshot of the origin/destination wallet or bank account (set by order type).
target_destination_details?Snapshot of the origin/destination wallet or bank account (set by order type).
source_asset*stringtarget_asset*stringsource_amount*stringDecimal string.
target_amount*stringDecimal string.
fee*stringDecimal string.
price_reference?stringDecimal string; FX orders only.
rate_base_asset?stringBase asset for price_reference; FX orders only.
failure_code?stringSet when status is canceled due to failure.
external_reference?stringdescription?stringcreated_at*stringFormat
date-timecompleted_at?stringFormat
date-timetimeline?array<>external_hash?stringOn-chain / partner transaction hash (deposit & withdrawal only).
curl -X GET 'https://api.betaramps.com/orders/string'Example Response
{ "id": "ord_0192f4e3-8a9b-7c6d-5e4f-3a2b1c0d9e8f", "type": "withdrawal", "status": "completed", "source_origin": "sub_0192f4e3-8a9b-7c6d-5e4f-3a2b1c0d9e8f", "target_destination_details": { "wallet_id": "wal_0192f4e6-1a2b-7c3d-8e4f-5a6b7c8d9e01", "wallet_address": "0xabc1230000000000000000000000000000000000", "network": "ethereum", "asset": "USDC" }, "source_asset": "USDC", "target_asset": "USDC", "source_amount": "100", "target_amount": "97.5", "fee": "2.5", "external_reference": "payout-1001", "created_at": "2026-01-15T10:00:00Z", "completed_at": "2026-01-15T10:05:00Z", "timeline": [ { "stage": "order_created", "label": "Order Created", "timestamp": "2026-01-15T10:00:00Z" }, { "stage": "compliance_validation", "label": "Compliance Validation", "timestamp": "2026-01-15T10:00:30Z" }, { "stage": "processing", "label": "Processing", "timestamp": "2026-01-15T10:01:00Z" }, { "stage": "settled", "label": "Settled", "timestamp": "2026-01-15T10:05:00Z" } ], "external_hash": "0xdeadbeef00000000000000000000000000000000000000000000000000000000"}