> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finsei.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Beneficiary

> Beneficiary is an entity that holds IBAN in it and can be used to create debit payments.

Company beneficiaries can be created via
[`POST /v2/beneficiary`](/api-reference/endpoint/post-v2-beneficiary)
and viewed via
[`GET /v1/beneficiary`](/api-reference/endpoint/get-v1-beneficiary)
or
[`GET /v1/beneficiary/{id}`](/api-reference/endpoint/get-v1-beneficiary-id)
methods in API.

Depending on the recipient you want to pay to, beneficiaries can be of two types: **Individual** and **Company**.

Crucial attributes while creating beneficiary are: currency, IBAN and entity\_type.

The combination of **Currency + IBAN** must be unique. You cannot create a beneficiary with the same IBAN and currency as an existing one - such attempts will be rejected.

Based on the currency you chose during beneficiary creation, additional fields can become required to fill in. If the currency is EUR but the beneficiary is not located in a SEPA country, the payment will be processed as a SWIFT transfer instead of SEPA, and more information will be required.

After creating a beneficiary, the following actions are available:

* **Send (pay)**
* **Delete**
* **Edit template name**