---
title: "List the partner's merchants"
method: GET
path: "/merchants"
tags: ["Merchants"]
---

# List the partner's merchants

`GET /merchants`

## Request

- Base URL: `https://gateway.pmnts.io/v2/partners`
- URL: `https://gateway.pmnts.io/v2/partners/merchants`
- Auth: HTTP basic

Returns the partner's merchants newest-first in the list envelope. Each
item is a summary (username only) — fetch the full merchant via
`GET /merchants/{username}`.

## Query parameters

- `limit` integer
- `starting_after` string

## Response `200`

Merchants list envelope.

- MerchantListEnvelope
  - `items` MerchantSummary[], required: The page of results. Each list endpoint overrides the item type.
    - `id` string, required: The merchant's username.
  - `next_cursor` string, nullable, required: Id to pass as `starting_after` for the next page; `null` on the last page.

## Other responses

- `401`: Missing or invalid HTTP Basic credentials.

---

[API](https://skmtc.dev/fatzebra/apis/fat-zebra-partner-api.md) - [All operations](https://skmtc.dev/fatzebra/apis/fat-zebra-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fatzebra/apis/fat-zebra-partner-api/revisions/10f1181ea916?raw)