List payout payees

GET /api/v2/storefront/billing/payees Lists the multi-entity payout payees on file — one per legal payout entity per payout currency. Account numbers are masked to their last 4 characters; the full value is never returned by the API. Your default payout details are separate — read them with Get billing config. Also available to agents as the list_payout_payees operation.

Request

curl https://api.interchange.io/api/v2/storefront/billing/payees \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Field	Type	Required	Notes
`targetCustomerId`	number	No	Query param. Parent customers list a child account’s payees

Response

{
  "payees": [
    {
      "id": 12,
      "entityName": "Meridian Media India Pvt Ltd",
      "currency": "INR",
      "beneficiaryName": "Meridian Media India Pvt Ltd",
      "addressLine1": "1 MG Road",
      "addressLine2": null,
      "city": "Bengaluru",
      "region": null,
      "postalCode": "560001",
      "countryCode": "IN",
      "accountNumberLast4": "6789",
      "bankIdentifierType": "SWIFT_BIC",
      "bankIdentifierValue": "HDFCINBB",
      "completedAt": "2026-07-09T09:30:00Z",
      "createdAt": "2026-07-09T09:30:00Z",
      "updatedAt": "2026-07-09T09:30:00Z"
    }
  ]
}

An empty array means no additional payout entities have been registered — the default payout details on the billing config are then the only payout account.

Set payout payee

Get billing config

The default payout details

Billing overview

How payouts work and why bank details are needed

Billing tasks

All billing operations

List billing accounts Set payout details

⌘I

Getting Started

Operating Your Storefront

Inventory Sources

Real-Time Targeting (TMP)

Approvals & Reviews

Buyer Onboarding

Demand & Signals

Proposals & Agents

Buyer Routing

Analytics & Activity

Billing

Account

Request

Parameters

Response

Set payout payee

Get billing config

Billing overview

Billing tasks

​Request

​Parameters

​Response

​Related

Set payout payee

Get billing config

Billing overview

Billing tasks

Request

Parameters

Response

Related