# Retrieve a beneficiary

Retrieves details of a beneficiary.

Endpoint: GET /beneficiaries/{id}
Version: 1.0.0
Security: JWT

## Path parameters:

  - `id` (string, required)
    The ID of the beneficiary

## Response 200 fields (application/json):

  - `id` (string)
    The unique identifier for the beneficiary.
    Example: "bene_5JU9yv0lGSUP"

  - `holder_name` (string)
    The name of the beneficiary.
    Example: "Test Arts & Crafts Pvt Ltd"

  - `account_number` (string)
    The account number of the beneficiary.
    Example: "1234567890"

  - `bank_name` (string)
    The name of the bank where the account is held.
    Example: "Yes Bank"

  - `beneficiary_type` (string)
    The type of beneficiary
    Enum: "individual", "business"

  - `bic_primary` (string)
    The primary BIC of the bank account. This is the BIC of the bank where the account is held. This is also known as the SWIFT code.
    Example: "QWERIN000"

  - `bic_secondary` (string)
    The local routing code or domestic clearing code of the bank account. For reference, this is the IFSC code in India, SORT in UK, ABA in the US, etc.
    Example: "YESB0000002"

  - `email` (string)
    The email address of the beneficiary.
    Example: "prabhat+beneficiaryArt@glomopay.com"

  - `address_line1` (string)
    The street address of the beneficiary.
    Example: "123 Main St"

  - `address_line2` (string)
    The second line of street address of the beneficiary.
    Example: "Near Apts"

  - `city` (string)
    The city where the beneficiary is located.
    Example: "Anytown"

  - `state` (string)
    The state where the beneficiary is located.
    Example: "Anystate"

  - `country` (string)
    The country where the beneficiary is located. Country should be sent as a [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) code.
    Example: "Ind"

  - `pincode` (string)
    The postal code of the beneficiary's address.
    Example: "560048"

  - `nickname` (string)
    A nickname for the beneficiary.
    Example: "Test Beneficiary"

  - `intermediate_bank_name` (string)
    The name of the intermediate bank, if any.
    Example: "Intermediate Bank"

  - `intermediate_bank_country` (string)
    The country of the intermediate bank, if any. Country should be sent as a [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) code.
    Example: "IND"

  - `intermediate_bank_swift_code` (string)
    The SWIFT code of the intermediate bank, if any.
    Example: "INTBANKSWIFT"

  - `created_at` (string)
    Timestamp representing when the beneficiary was created
    Example: "2021-06-01T12:00:00Z"

  - `updated_at` (string)
    Timestamp representing when the beneficiary was last updated
    Example: "2021-06-01T12:00:00Z"

## Response 404 fields (application/json):

  - `error` (string)
    Enum: "Not found"

  - `message` (string)
    Entity not found
    Enum: "Entity not found"