Skip to main content
GET
/
accounts
/
{accountId}
/
transfers
/
{transferId}
Get transfer details
curl --request GET \
  --url https://api.venlyfinance.com/v1/accounts/{accountId}/transfers/{transferId} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "result": {
    "id": "a1b2c3d4-e5f6-4789-9abc-def012345678",
    "senderAccountId": "b2a1f0e9-8c7d-4e3a-9f21-0a1b2c3d4e5f",
    "receiverAccountId": "c3b2a1f0-9d8c-4e3a-bf21-1a2b3c4d5e60",
    "chain": "BASE",
    "asset": "USDC",
    "amount": 25,
    "description": "Invoice settlement",
    "idempotencyKey": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "COMPLETED",
    "transactionHash": "0xa1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
    "createdAt": "2026-01-15T09:30:00Z",
    "updatedAt": "2026-01-15T09:30:02Z"
  }
}
Returns the transfer details, including status (PENDING/COMPLETED/FAILED) and, for fiat transfers, the fiatOrigin block. The account must be the sender or receiver, otherwise the API returns 404. Concept guide: Transfers

Authorizations

​
Authorization
string
header
required

OAuth2 client credentials flow. Token endpoints:

Path Parameters

​
accountId
string<uuid>
required

Unique account identifier

​
transferId
string<uuid>
required

The transfer ID

Response

Transfer details

​
success
boolean

Indicates whether the request was successful

​
result
object