---
title: "List Beneficiary Transactions"
method: GET
path: "/v1/beneficiaries/{beneficiary_id}/transactions"
tags: ["Transactions"]
---

# List Beneficiary Transactions

`GET /v1/beneficiaries/{beneficiary_id}/transactions`

Retrieve a paginated list of all transactions for a specific beneficiary

## Path parameters

- `beneficiary_id` string, uuid, required

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Transactions retrieved successfully

- object
  - `data` object
    - `pagination` object
      - `current_page` integer
      - `per_page` integer
      - `total_page` integer
      - `total` integer
    - `transactions` object[]
      - `id` string, uuid
      - `transaction_type` string
      - `beneficiary_id` string, uuid
      - `hash` string, nullable
      - `transaction_ref_id` string
      - `from_amount` number
      - `payout_amount` number
      - `processing_amount` number
      - `status` 'CREATED' | 'PENDING' | 'COMPLETED' | 'FAILED'
      - `fx_rate` number
      - `developer_fee` number
      - `developer_fee_percentage` number
      - `developer_fee_fixed` number
      - `from_currency` string
      - `payout_currency` string
      - `created_at` string, date-time
      - `updated_at` string, date-time

## Other responses

- `401` — Authentication failed due to invalid credentials

---

[API](https://skmtc.net/fin/apis/fin-com-api.md) · [All operations](https://skmtc.net/fin/apis/fin-com-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fin/fin-com-api/revisions/6e69503ee7b8/schema)