# Get Payee Details

Returns a single payee by identifier. The payload uses the same shape as items in the
list endpoint: Bill payees usually include financial_rules and capabilities;
Topup payees usually include bundles.

Endpoint: GET /api/v1/payees/{id}
Version: 1.0.0
Security: BearerAuth

## Path parameters:

  - `id` (string, required)
    Unique payee identifier (UUID).
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

## Response 200 fields (application/json):

  - `payee_id` (string, required)
    Unique payee identifier.
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

  - `name` (string, required)
    Display name of the payee.
    Example: "CFE"

  - `category` (string, required)
    Industry or category label for the payee.
    Example: "Electricity"

  - `type` (string, required)
    Payee category for integration behavior (e.g. Bill, Topup).
    Example: "Bill"

  - `reference_config` (object, required)
    Optional hints for validating the payer reference or account number format.

  - `reference_config.regex` (string,null, required)
    Regular expression pattern used to validate references, when available.
    Example: "^[0-9]{12}$"

  - `financial_rules` (object)
    Payment amount constraints and billing rules. Typically present when type is Bill;
may be omitted for other payee types.

  - `financial_rules.minimum_amount` (string, required)
    Minimum payment amount (decimal string in currency units).
    Example: "1"

  - `financial_rules.maximum_amount` (string, required)
    Maximum payment amount (decimal string in currency units).
    Example: "50000"

  - `financial_rules.payment_type` (string, required)
    Supported payment mode for this payee.
    Enum: "totals", "partials"

  - `financial_rules.accepts_expired` (boolean, required)
    Whether payments are accepted when the bill is expired.

  - `capabilities` (object)
    Operational capabilities. Typically present when type is Bill;
may be omitted for other payee types.

  - `capabilities.has_balance` (boolean, required)
    Whether a balance inquiry can be performed for this payee.
    Example: true

  - `capabilities.connection_mode` (string, required)
    How the payee integration is executed.
    Enum: "online", "batch"

  - `bundles` (array,null)
    Predefined top-up amounts. Typically present when type is Topup.
Values follow the format returned by the API (string or numeric).
    Example: ["10.00","20.00","50.00"]

## Response 401 fields (application/json):

  - `errors` (array, required)
    Example: ["Access denied"]

## Response 404 fields (application/json):

  - `error` (string, required)
    Message describing why the payee could not be found.
    Example: "Couldn't find Payee with 'id'=00000000-0000-0000-0000-000000000000"