List merchants for the tenant

List the merchants on your tenant, a page at a time.

Use cardSetup to show only merchants at a given card-setup stage (not_started, in_progress, ready or blocked). It uses the same rule as GET /v1/merchant/cocoon/setup-status, and pagination.total counts every match, not just the current page.

With cardSetup, at most 5,000 merchants can be checked after your other filters are applied. Above that, the request fails with 422 CARD_SETUP_FILTER_TOO_BROAD. Narrow it with status, risk_tier or mcc.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
≥ 1

Page number

integer
1 to 100

Page size

string
enum

Merchant status

Allowed:
string
enum

Risk tier

Allowed:
string

Exact MCC

string

<field>[:asc|desc]; field is createdAt, name, status, riskTier, mcc or mtdVolume (default createdAt:desc; ties break on id)

string
enum

Cocoon card setup summary

Allowed:
Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json