---
title: "Get Payment Channel Details"
method: GET
path: "/v4/payees/{payeeId}/paymentChannels/{paymentChannelId}"
tags: ["Payee Payment Channels"]
---

# Get Payment Channel Details

`GET /v4/payees/{payeeId}/paymentChannels/{paymentChannelId}`

Get the payment channel details for the payee

## Path parameters

- `payeeId` string, uuid, required
- `paymentChannelId` string, uuid, required

## Query parameters

- `payable` boolean
- `sensitive` boolean

## Response `200`

Success response, request completed okay

- PaymentChannelResponseV4
  - `id` string, uuid, required
  - `payeeId` string, uuid
  - `paymentChannelName` string, required
  - `accountName` string, required
  - `channelType` string, required — Payment channel type. One of the following values: CHANNEL_BANK
  - `countryCode` string, required — Valid ISO 3166 2 character country code. See the <a href="https://www.iso.org/iso-3166-country-codes.html" target="_blank" a>ISO specification</a> for details.
  - `routingNumber` string
  - `accountNumber` string
  - `iban` string — Must match the regular expression ```^[A-Za-z0-9]+$```.
  - `currency` string, required — Valid ISO 4217 3 letter currency code. See the <a href="https://www.iso.org/iso-4217-currency-codes.html" target="_blank" a>ISO specification</a> for details.
  - `payorIds` string[]
  - `payeeName` string
  - `bankName` string
  - `bankSwiftBic` string
  - `bankAddress` AddressV4
    - `line1` string, required
    - `line2` string, nullable
    - `line3` string, nullable
    - `line4` string, nullable
    - `city` string, required
    - `countyOrProvince` string, nullable
    - `zipOrPostcode` string, nullable
    - `country` string, required — Valid ISO 3166 2 character country code. See the <a href="https://www.iso.org/iso-3166-country-codes.html" target="_blank" a>ISO specification</a> for details.
  - `deleted` boolean
  - `enabled` boolean
  - `disabledReasonCode` string
  - `disabledReason` string
  - `payable` boolean — Whether this payment channel is payable

## Other responses

- `204` — payee not payable but the request is valid
- `400` — Invalid request. See Error message payload for details of failure
- `401` — Invalid access token. May be expired or invalid
- `403` — The authentication does not have permissions to access the resource This usually occurs when there is a valid authentication instance (client or user) but they do not have the required permissions
- `404` — The resource was not found or is no longer available

## Changes

- **2026-07-13** `05c3f09fc50a` — 2 breaking
  - the `bankAddress/zipOrPostcode` response property's maxLength was increased from `15` to `20` for the response status `200`
  - the `bankAddress/zipOrPostcode` response property's minLength was decreased from `3` to `2` for the response status `200`
- **2023-08-15** `b924ba134e09` — 1 info
  - endpoint added
- **2019-07-15** `ced8e167a97c` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/changes/v4/payees/:payeeId/paymentChannels/:paymentChannelId/get.md)

---

[API](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis.md) · [All operations](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/revisions/05c3f09fc50a?raw)