Skip to main content
POST
POST /api/v1/transfers

Authorizations

Authorization
string
header
required

Bearer token from Geomi. See Authentication for setup instructions.

Body

application/json

Request body for POST /api/v1/transfers.

Posted by the web client after a deposit or withdrawal confirms, to capture attribution metadata (how/where the user funded) that the chain can't see. transfer_id is a client-minted UUID used as the dedup key.

account
string
required
amount
number<double>
required
direction
string
required

'deposit' | 'withdraw'

method
string
required

'direct' | 'mesh' | 'bridge'

transfer_id
string
required
asset
string | null
broker
string | null
origin_chain
string | null
tx_hash
string | null
wallet_provider
string | null

Response

Transfer recorded

success
boolean
required