---
title: "List a merchant's acquirer connections"
method: GET
path: "/merchants/{username}/acquirers"
tags: ["Acquirer connections"]
---

# List a merchant's acquirer connections

`GET /merchants/{username}/acquirers`

## Request

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

Returns the merchant's acquirer connections newest-first in the list
envelope.

## Query parameters

- `limit` integer
- `starting_after` string

## Response `200`

Acquirer connections list envelope.

- AcquirerConnectionListEnvelope
  - `items` AcquirerConnection[], required: The page of results. Each list endpoint overrides the item type.
    - `acquirer_name` string, nullable, required: The acquirer's display name (e.g. `NAB`).
    - `merchant_id` string, nullable: The acquirer-assigned MID (e.g. `ent_a1b2c3d4`).
    - `terminal_id` string, nullable: The acquirer-assigned TID (e.g. `T0001`), or a Fat Zebra-generated 8-character placeholder (e.g. `ACMEC001`) if none was supplied at board time. Immutable once set.
    - `currencies` string[]: Currencies the connection can transact.
    - `schemes` string[]: Networks the merchant can transact for this acquirer.
    - `modes` string[]: Transaction modes the connection supports.
    - `wallets` string[]: Wallets the connection accepts.
    - `three_ds_enabled` boolean: Whether a boarded processor for this acquirer supports 3DS.
    - `status` 'enabled' | 'disabled', required: Routing toggle across the underlying links — disable to turn the connection off without deleting it.
  - `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.
- `404`: Resource not found.

---

[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)