---
title: "Fetch all bank account beneficiaries and bank transfer type"
method: GET
path: "/ledger/fiat-beneficiaries"
tags: ["ledger-beneficiaries"]
---

# Fetch all bank account beneficiaries and bank transfer type

`GET /ledger/fiat-beneficiaries`

## Request

- Base URL: `https://external.dev.onboardpay.co`
- URL: `https://external.dev.onboardpay.co/ledger/fiat-beneficiaries`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/nestechops/apis/onboard-external-api-gateway/docs/ledger/fiat-beneficiaries/get.ts> (a function with typed inputs; its response is checked against the schema)

This operation allows the client to fetch all beneficiary by accounts and their transaction type

## Query parameters

- `currency` string
- `accountHolderType` 'INDIVIDUAL' | 'BUSINESS'
- `page` integer
- `size` integer

## Response `200`

Beneficiary fetched

- BeneficiaryList: Base object for paginated list
  - `name` string: Descriptive name for the list
  - `size` integer: Positive integer
  - `totalItems` integer: Positive integer
  - `nextPage` integer: Positive integer
  - `previousPage` integer: Positive integer
  - `content` Beneficiary[]: List of Beneficiaries
    - `id` string, uuid, required: Beneficiary identifier
    - `accountNumber` string, required: Beneficiary account number, for international payments like SEPA, this is the IBAN
    - `accountName` string, required: Beneficiary account name
    - `currency` string, required
    - `beneficiaryType` string: Discriminator value for beneficiary type. Allowed values include: - BeneficiaryLocalBankAccount - BeneficiarySepaBankAccount - BeneficiaryACHBankAccount - BeneficiarySwiftBankAccount - BeneficiaryMobileWalletAccount
    - `isThirdParty` boolean: Flag to indicate if the beneficiary is a third party
    - `accountHolderType` 'INDIVIDUAL' | 'BUSINESS', required

## Other responses

- `400`: Request could not be validated
- `401`: Client is not authorized to make request
- `403`: Expected permission is not available.
- `default`: Internal Server Error

## Changes

- **2026-07-26** `a3c4e2742615`: 2 info
  - the endpoint scheme security `HMACAuth` was added to the API
  - the endpoint scheme security `authToken` was removed from the API
- **2026-07-13** `fc790ea4deb6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nestechops/apis/onboard-external-api-gateway/changes/ledger/fiat-beneficiaries/get.md)

---

[API](https://skmtc.dev/nestechops/apis/onboard-external-api-gateway.md) - [All operations](https://skmtc.dev/nestechops/apis/onboard-external-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/nestechops/apis/onboard-external-api-gateway/revisions/5da9ec1b2573?raw)