> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List payout payees

> List the payout bank accounts on file for each legal entity and payout currency (masked)

`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](/v2/storefront/billing/tasks/get-billing-config). Also
available to agents as the `list_payout_payees` operation.

## Request

```bash theme={null}
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

```json theme={null}
{
  "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.

## Related

<CardGroup cols={2}>
  <Card title="Set payout payee" href="/v2/storefront/billing/tasks/set-payout-payee" icon="building">
    Register or update an entity's bank account
  </Card>

  <Card title="Get billing config" href="/v2/storefront/billing/tasks/get-billing-config" icon="gear">
    The default payout details
  </Card>

  <Card title="Billing overview" href="/v2/storefront/billing/overview" icon="credit-card">
    How payouts work and why bank details are needed
  </Card>

  <Card title="Billing tasks" href="/v2/storefront/billing/tasks" icon="list-check">
    All billing operations
  </Card>
</CardGroup>