For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Get support
HomeDocsAPI ReferenceRelease Notes
HomeDocsAPI ReferenceRelease Notes
  • Payments API
    • POSTRefresh API Keys
    • POSTCharge
    • POSTCapture
    • POSTVoid or Refund
    • POSTCheck Surcharge
    • POSTCreate Hosted Payment Page
    • PUTEdit Hosted Payment Page
    • POSTCreate Vault Payment Account
    • GETGet Vault Payment Account
    • DELDelete a Vault Payment Account
    • PUTUpdate Vault Account Details
    • POSTCreate Billing Plan
    • GETGet Billing Plan
    • DELCancel Billing Plan
  • Authentication (Reporting & Boarding)
    • POSTGet access token
  • Reporting API
    • GETGet transactions data
    • GETGet deposits data
    • GETGet chargebacks data
    • GETGet adjustments data
  • Boarding API
    • GETList merchants
    • POSTCreate a new merchant
    • GETGet a single merchant
Get support
LogoLogo

List merchants

GET
https://apps.runpayments.io/ords/relay/api/boarding/v1/merchants
GET
/ords/relay/api/boarding/v1/merchants
$curl https://apps.runpayments.io/ords/relay/api/boarding/v1/merchants \
> -H "Authorization: Bearer <token>"
1{
2 "items": [
3 {
4 "merchant_id": 10234,
5 "platform": "payroc",
6 "rep_code": "REP789",
7 "customer_id": 56789,
8 "mid": "MID123456789",
9 "dba_name": "Sunrise Coffee Shop",
10 "legal_name": "Sunrise Coffee LLC",
11 "merchant_status": "live",
12 "pended": 0,
13 "merchant_type_id": 3,
14 "external_crm_id": "CRM-4587",
15 "custom_01": "Priority client"
16 }
17 ],
18 "hasMore": true,
19 "limit": 1,
20 "offset": 1,
21 "count": 1,
22 "links": [
23 {
24 "rel": "next",
25 "href": "https://apps.runpayments.io/ords/relay/api/boarding/v1/merchants?limit=1&offset=2"
26 }
27 ]
28}
Retrieve a list of merchants accessible to the authenticated user. Returns merchants where the current user is associated as a sales officer, sales partner, or distributor client.
Was this page helpful?
Previous

Create a new merchant

Next
Built with

Query parameters

limitintegerOptional1-1000Defaults to 100

Maximum number of merchants to return (default 100, max 1000)

offsetintegerOptional>=0Defaults to 0

Number of merchants to skip for pagination (default 0)

merchant_statusstringOptional
Filter by merchant status
platformenumOptional
Filter by platform
Allowed values:
rep_codestringOptional
Filter by representative code

Response

Merchants retrieved successfully
itemslist of objects
Array of merchant records
hasMoreboolean
Whether there are more merchants available
limitinteger
The limit parameter used for this request
offsetinteger
The offset parameter used for this request
countinteger
Number of merchants returned in this response
linkslist of objects
HATEOAS links for pagination and related resources

Errors

400
Bad Request Error
401
Unauthorized Error