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

# Get beneficiary by ID

> Retrieve a specific beneficiary and their account details



## OpenAPI

````yaml /openapi.json get /v1/beneficiaries/{id}
openapi: 3.0.0
info:
  contact: {}
  description: >-
    Comprehensive payment platform API supporting fiat and crypto payments,
    currency conversion, and compliance management
  title: Zuba Payment Platform API
  version: '1.0'
servers: []
security: []
tags:
  - description: Manage M2M API keys and credentials
    name: API Keys
  - description: Internal ledger accounts and transactions
    name: Ledger
  - description: Handle incoming payments and deposits
    name: Pay-ins
  - description: Manage payouts, beneficiaries, and SEPA transfers
    name: Payouts
  - description: Manage outbound webhook endpoints and deliveries
    name: Webhooks
paths:
  /v1/beneficiaries/{id}:
    get:
      tags:
        - Payouts
      summary: Get beneficiary by ID
      description: Retrieve a specific beneficiary and their account details
      operationId: PayoutController_getBeneficiary
      parameters:
        - description: Unique identifier for the beneficiary
          in: path
          name: id
          required: true
          schema:
            example: 123e4567-e89b-12d3-a456-426614174000
            format: uuid
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BeneficiaryDto'
          description: Beneficiary found
        '401':
          description: Unauthorized
        '404':
          description: Beneficiary not found
        '500':
          description: Internal Server Error
      security:
        - bearer: []
components:
  schemas:
    BeneficiaryDto:
      properties:
        accounts:
          description: Array of associated payment accounts
          items:
            $ref: '#/components/schemas/AccountDto'
          type: array
        address:
          description: Address line 1 of the beneficiary
          example: Hauptstraße 123
          type: string
        addressLine2:
          description: Address line 2 of the beneficiary
          example: Apt 4B, 3rd Floor
          type: string
        city:
          description: City of the beneficiary
          example: Berlin
          type: string
        country:
          description: Country code (ISO 3166-1 alpha-2)
          example: DE
          type: string
        countrySubdivision:
          description: Country subdivision code (e.g., US state code "NY", "CA")
          example: NY
          type: string
        createdAt:
          description: ISO timestamp when the beneficiary was created
          example: '2024-01-15T10:30:00Z'
          format: date-time
          type: string
        dateOfBirth:
          description: Date of birth in YYYY-MM-DD format (individual beneficiaries only).
          example: '1985-05-20'
          type: string
        email:
          description: Email address of the beneficiary
          example: john.doe@example.com
          type: string
        id:
          description: Unique identifier for the beneficiary
          example: 123e4567-e89b-12d3-a456-426614174000
          format: uuid
          type: string
        middleName:
          description: Middle name of the beneficiary
          example: James
          type: string
        name:
          description: Full name of the beneficiary
          example: John Doe
          type: string
        notes:
          description: Notes about the beneficiary
          example: Regular client, prefers SEPA Instant
          type: string
        postcode:
          description: Postal code of the beneficiary
          example: '10115'
          type: string
        status:
          description: Beneficiary status
          enum:
            - active
            - inactive
            - suspended
          example: active
          type: string
        type:
          description: Beneficiary type
          enum:
            - individual
            - business
          example: individual
          type: string
        updatedAt:
          description: ISO timestamp when the beneficiary was last updated
          example: '2024-01-15T10:30:00Z'
          format: date-time
          type: string
      required:
        - id
        - name
        - type
        - country
        - accounts
        - status
        - createdAt
        - updatedAt
      type: object
    AccountDto:
      properties:
        createdAt:
          description: Creation timestamp
          example: '2024-01-15T10:30:00Z'
          format: date-time
          type: string
        currency:
          description: >-
            Currency code (ISO 4217). Default enabled currencies: EUR, USD, GBP,
            USDC, EURC, NGN. Contact your account manager to enable additional
            currencies.
          enum:
            - EUR
            - USD
            - GBP
            - USDC
            - USDT
            - EURC
            - NGN
            - XOF
            - XAF
            - GHS
          example: EUR
          type: string
        data:
          additionalProperties: true
          description: Account data specific to the account type
          example:
            bic: DEUTDEFF
            iban: DE89370400440532013000
          type: object
        id:
          description: Unique identifier for the account
          example: 123e4567-e89b-12d3-a456-426614174000
          format: uuid
          type: string
        resolutionStatus:
          description: >-
            Resolution status of the account number against the bank (NGN bank
            accounts only).
          enum:
            - unresolved
            - resolved
            - invalid
          example: resolved
          type: string
        resolvedAccountName:
          description: >-
            Account-holder name returned by the bank when the account was
            resolved, if available.
          example: JANE DOE
          type: string
        status:
          description: Status of the account
          enum:
            - active
            - suspended
            - closed
          example: active
          type: string
        type:
          description: Type of payment account
          enum:
            - iban
            - card
            - bank_account
            - wallet
            - swift
            - mobile
          example: iban
          type: string
        updatedAt:
          description: Last update timestamp
          example: '2024-01-15T10:35:00Z'
          format: date-time
          type: string
      required:
        - id
        - type
        - currency
        - data
        - status
        - createdAt
        - updatedAt
      type: object
  securitySchemes:
    bearer:
      bearerFormat: JWT
      description: Enter Auth0 JWT token
      scheme: bearer
      type: http

````