---
title: "Show beneficiary"
method: GET
path: "/v2/beneficiaries/{id}"
tags: ["Beneficiaries"]
---

# Show beneficiary

`GET /v2/beneficiaries/{id}`

OAuth scope: `organization.read`

---
Get a single beneficiary.

---

## Attributes details

#### Trusted
`trusted` indicates whether you can automate transfer through API to the beneficiary or not.

#### Timestamps
Each beneficiary contains two timestamps:

* `created_at`, UTC, the time at which the beneficiary was first recorded.
* `updated_at`, UTC, the time at which the beneficiary was last updated.

##### Status
`status` can contain the following values

* `pending`: Beneficiary is created but no Strong Customer Authentication or Transfer has ever been done on this beneficiary.
* `validated`: Beneficiary is created and at least one Strong Customer Authentication or Transfer has been done to this beneficiary.
* `declined`: Beneficiary is malformatted and prevent from Qonto to processing transfer.

##### Bank account
Fields in the `bank_account` object will be populated depending upon the type of the account. If the type is:
  - Swift BIC or SEPA: `iban`, `currency` and `bic` will be present.
  - Swift code: `account_number`, `swift_sort_code`, `intermediary_bank_bic` and `currency` will be present.
  - Swift routing number: `account_number`, `routing_number`, `intermediary_bank_bic` and `currency` will be present.

## Path parameters

- `id` string, required

## Headers

- `X-Qonto-Staging-Token` string

## Response `200`

returns a beneficiary

- object
  - `beneficiary` Beneficiary
    - `id` string, uuid, required
    - `name` string, required
    - `status` 'pending' | 'declined' | 'validated', required
    - `trusted` boolean, required
    - `bank_account` object
      - `iban` string
      - `bic` string
      - `currency` string
      - `account_number` string
      - `routing_number` string
      - `intermediary_bank_bic` string
      - `swift_sort_code` string
    - `created_at` string, required
    - `updated_at` string, required

## Other responses

- `404` — returns a not found error

---

[API](https://skmtc.net/hiit-consulting-fr/apis/qonto.md) · [All operations](https://skmtc.net/hiit-consulting-fr/apis/qonto/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hiit-consulting-fr/qonto/revisions/25208d6f9deb/schema)