# Get channel details

Retrieves the details of a specific channel by its ID using account-based routing.

Endpoint: GET /v1/collections/channels/{channel_id}
Version: 1.0.0
Security: Bearer

## Security:

  - `Bearer` (unknown)
    http bearer JWT

## Path parameters:

  - `channel_id` (string, required)
    Unique identifier of the channel to retrieve

## Response 200:

  - `200` (unknown)
    Successful response

## Response 200 fields (application/json):

  - `id` (string, required)
    Unique identifier for the channel
    Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

  - `payer` (object, required)
    Payer partner details

  - `payer.id` (string, required)
    Unique identifier for the payer partner
    Example: e471b938-98ad-45e4-b144-53a556ea047d

  - `payer.name` (string, required)
    Full name of the payer partner
    Example: Nigerian Imports Ltd.

  - `payer.email` (string, required)
    Email address of the payer partner
    Example: nigerian@imports.com

  - `beneficiary` (object, required)
    Beneficiary partner details

  - `beneficiary.id` (string, required)
    Unique identifier of the beneficiary partner
    Example: 01467076-8bb0-41c1-ad54-5751dd4a9e80

  - `beneficiary.name` (string, required)
    Full name of the beneficiary partner
    Example: Hong Kong Exports Ltd.

  - `beneficiary.email` (string, required)
    Email address of the beneficiary partner
    Example: hongkong@exports.com

  - `account` (object, required)
    Account associated to this channel, which funds will be routed to

  - `account.id` (string, required)
    Unique identifier for the account
    Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

  - `account.beneficiary_id` (string, required)
    Unique identifier of the beneficiary partner
    Example: 291ecf34-a01d-466a-b0fd-662a88b7a1bb

  - `account.currency` (string, required)
    Currency for the account
    Example: USD

  - `account.type` (string, required)
    Type of account
    Enum: "FIAT", "CRYPTO"

  - `payment_methods` (array, required)
    Available payment methods with full deposit instructions

  - `payment_methods.type` (string, required)
    Discriminator: indicates blockchain rail
    Enum: "BLOCKCHAIN"

  - `payment_methods.network` (string, required)
    Supported blockchain networks
    Enum: "ETHEREUM", "ETHEREUM_SEPOLIA_TESTNET", "SOLANA", "SOLANA_TESTNET", "XRPL", "XRPL_TESTNET"

  - `payment_methods.address` (string, required)
    Blockchain wallet address for receiving funds
    Example: 0xBb592aaaF9AcE2fbE3F735645819FA94c95a9cb5

  - `payment_methods.currency` (string, required)
    Cryptocurrency asset symbol
    Example: RLUSD

  - `payment_methods.destination_tag` (string)
    Optional destination tag/memo for networks that require one (e.g. XRPL)
    Example: 12345

  - `payment_methods.type` (string, required)
    Discriminator: indicates Fedwire rail
    Enum: "FEDWIRE"

  - `payment_methods.account_number` (string, required)
    Bank account number
    Example: XXXX7890

  - `payment_methods.routing_number` (string, required)
    ABA routing number
    Example: 021000021

  - `payment_methods.swift_code` (string)
    SWIFT/BIC code for international transfers
    Example: CHASUS33

  - `payment_methods.memo` (string)
    Reference memo to include with the transfer
    Example: ACC-123456

  - `payment_methods.type` (string, required)
    Discriminator: indicates ACH rail
    Enum: "ACH"

  - `payment_methods.swift_code` (string)
    SWIFT/BIC code (optional for ACH)
    Example: CHASUS33

  - `payment_methods.type` (string, required)
    Discriminator: indicates RTP rail
    Enum: "RTP"

  - `payment_methods.swift_code` (string)
    SWIFT/BIC code (optional for RTP)
    Example: CHASUS33

  - `payment_methods.type` (string, required)
    Discriminator: indicates PIX rail
    Enum: "PIX"

  - `payment_methods.pix_key` (string, required)
    PIX key for receiving payments
    Example: 12345678901

  - `payment_methods.pix_key_type` (string, required)
    Type of PIX key
    Enum: "CPF", "CNPJ", "EMAIL", "PHONE", "RANDOM"

  - `payment_methods.beneficiary_name` (string)
    Name of the beneficiary as registered with PIX
    Example: Empresa ABC Ltda

  - `payment_link` (string, required)
    URL for payer UI to access this channel
    Example: https://collections.ripplenet.com/pay/channel/3fa85f64-5717-4562-b3fc-2c963f66afa6

  - `status` (string, required)
    Status of the channel
    Enum: "ACTIVE", "INACTIVE", "CLOSED"

  - `reason` (string)
    Reason for current status (if applicable)
    Example: null

  - `created_at` (string, required)
    ISO 8601 timestamp when the channel was created
    Example: 2025-09-18T22:54:00.542Z

  - `updated_at` (string, required)
    ISO 8601 timestamp when the channel was last updated
    Example: 2025-09-18T22:54:00.542Z

## Response 400:

  - `400` (unknown)
    Bad Request - Invalid input parameters

## Response 400 fields (application/json):

  - `code` (string, required)
    Error code identifying the type of error

  - `reason` (string, required)
    Human-readable error message

## Response 401:

  - `401` (unknown)
    Unauthorized - Invalid or missing authentication

## Response 401 fields (application/json):

  - `code` (string, required)
    Error code identifying the type of error

  - `reason` (string, required)
    Human-readable error message

## Response 404:

  - `404` (unknown)
    Not Found - Channel does not exist

## Response 404 fields (application/json):

  - `code` (string, required)
    Error code identifying the type of error

  - `reason` (string, required)
    Human-readable error message

## Response 500:

  - `500` (unknown)
    Internal server error

## Response 500 fields (application/json):

  - `code` (string, required)
    Error code identifying the type of error

  - `reason` (string, required)
    Human-readable error message

## Response 200 examples:

  - `Example crypto channel response` (unknown)

  - `Example fiat channel response` (unknown)

  - `Example BRL fiat channel response with PIX` (unknown)

