API Reference2026-02-19.previewMerchants
List merchants
GET
header
Api-Key<token>status?stringFilter by merchant status
Value in
"active""inactive""suspended"search?stringSearch by merchant name or ID (case-insensitive)
Length
1 <= length <= 256cursor?stringOpaque pagination cursor — use the value from nextCursor in the previous response.
limit?integerPage size (default 20, max 100)
Range
1 <= value <= 100Default
20Merchants list
application/json- response
merchants*array<>totalCount*integerTotal number of merchants matching the query (ignoring pagination)
Range
-9007199254740991 <= value <= 9007199254740991nextCursor*|Cursor for the next page, or null if no more results
curl -X GET 'https://api.pay.walletconnect.com/v1/merchants'{ "merchants": [ { "id": "mrch_7kBz2qR9xPvLmN4Yw", "name": "Acme Store", "email": "billing@acme.store", "status": "active", "iconUrl": "https://imagedelivery.net/example/acme-icon.png", "createdAt": "2025-06-15T10:30:00.000Z" }, { "id": "mrch_Qx8fTp3YwKjR5vNm2", "name": "Widget Co", "email": null, "status": "active", "iconUrl": null, "createdAt": "2025-07-01T08:00:00.000Z" } ], "totalCount": 2, "nextCursor": null}