---
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`

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

---

[API](https://skmtc.net/nestechops/apis/onboard-external-api-gateway.md) · [All operations](https://skmtc.net/nestechops/apis/onboard-external-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nestechops/onboard-external-api-gateway/versions/29661adc1ffc/schema)