---
title: "Your KES payout destinations"
method: GET
path: "/v1/payout-accounts"
tags: ["Partner API"]
---

# Your KES payout destinations

`GET /v1/payout-accounts`

## Request

- Base URL: `https://sandbox.onlink.africa`
- URL: `https://sandbox.onlink.africa/v1/payout-accounts`
- Auth: API key in header `X-OnLink-Key`

The destinations a sell order may name in payoutAccountId. Read-only: destinations are registered by OnLink, not through this API, so your API credential cannot add a place for money to go. Only active destinations are listed. Account numbers are returned as the last four digits only — you select a destination by id and never type its number.

## Response `200`

Your active payout destinations

- PayoutDestinationResponseDto[]
  - `payoutAccountId` string, uuid, required: The id to pass as `payoutAccountId` on POST /v1/orders/sell. Destinations are registered by OnLink out of band, never through this API, so this is a selection rather than an instruction.
  - `accountNumberLast4` string, required: The **last four digits only** of the destination account number. There is no route on this API that returns more, by design — you select a destination by id and never type its number.
  - `accountName` string, required: The beneficiary name exactly as the receiving bank holds it. Returned whole so you can tell two destinations at the same bank apart.
  - `bankCode` string, nullable, required: The receiving bank’s code. **`null` means an on-us destination at our own bank, not missing data** — do not render it as an error or a gap.
  - `label` string, nullable, required: The label OnLink recorded for this destination, or `null`. Never used for routing.

## Other responses

- `401`: Signature missing or invalid

---

[API](https://skmtc.dev/onlink/apis/onlink-partner-api.md) - [All operations](https://skmtc.dev/onlink/apis/onlink-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/onlink/apis/onlink-partner-api/revisions/1d1c6a3671f2?raw)