Skip to main content
GET
/
v1
/
beneficiaries
/
{beneficiary_id}
/
transactions
List Beneficiary Transactions
curl --request GET \
  --url https://sandbox.api.fin.com/v1/beneficiaries/{beneficiary_id}/transactions \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "pagination": {
      "current_page": 1,
      "per_page": 10,
      "total_page": 1,
      "total": 1
    },
    "transactions": [
      {
        "id": "f656afd1-7735-43b0-b630-04f0ff7158b3",
        "transaction_type": "OFFRAMP",
        "beneficiary_id": "4c0c63db-580f-4e16-af24-e84ea8937dd8",
        "hash": null,
        "transaction_ref_id": "f656afd1-7735-43b0-b630-04f0ff7158b3",
        "from_amount": 3,
        "payout_amount": 4.35,
        "processing_amount": 3,
        "status": "COMPLETED",
        "fx_rate": 1.45,
        "developer_fee": 0,
        "developer_fee_percentage": 0.45,
        "developer_fee_fixed": 1.25,
        "from_currency": "USDC",
        "payout_currency": "AUD",
        "created_at": "2025-12-31T14:50:38.587606Z",
        "updated_at": "2025-12-31T14:56:28.405775Z"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

Bearer token authentication. Obtain token from /v1/oauth/token endpoint

Path Parameters

beneficiary_id
string<uuid>
required

Unique identifier for the beneficiary

Query Parameters

page
integer
default:1

Page number for pagination

Required range: x >= 1
limit
integer
default:10

Number of transactions per page

Required range: 1 <= x <= 100

Response

OK - Transactions retrieved successfully

data
object