Merchants
List Merchants
Returns sub-merchants under the authenticated partner account.
Supported query options:
- Pagination: limit, page
- Text search: search
- Sorting: sort
- Field filters: filter[field][eq]=value
Supported filter fields:
- id
- external_id
- reference_id
- name
- legal_name
- underwriting_status
- created_at
Supported sort fields:
- created_at
- id
- name
- legal_name
Use - prefix for descending sort, for example sort=-name.
get/merchants
Request
- Base URLhttps://app-sandbox.resolvepay.com/api
- Auth
- HTTP bearer
- or HTTP basic
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
limitinteger
Maximum number of merchants to return.
pageinteger
Page number for paginated merchant results.
searchstring
Case-insensitive text search across merchant id, name, email, and legal_name.
sort'created_at' | '-created_at' | 'id' | '-id' | 'name' | '-name' | 'legal_name' | '-legal_name'
Sort field for merchant results.
Prefix with - for descending order.
Filter merchants by allowlisted fields.
Filter semantics: filter[field][operator]=value.
Supported filters:
- filter[id][eq]=mrc_1234567890abcdef
- filter[reference_id][eq]=partner-crm-12345
- filter[legal_name][eq]=Alpha Supply LLC
- filter[underwriting_status][eq]=pending
- filter[created_at][eq]=2026-03-11T00:00:00.000Z
Response
Paginated list of merchants.
Example response
{
"count": 2,
"page": 1,
"limit": 25,
"results": [
{
"id": "mrc_1234567890abcdef",
"reference_id": "partner-crm-12345",
"legal_business_name": "Acme Supply LLC",
"dba_name": "Acme Industrial",
"business_address": {
"line1": "100 Main St",
"line2": "Suite 200",
"city": "Austin",
"state": "TX",
"postal_code": "78701",
"country": "US"
},
"business_email": "ops@acmesupply.com",
"business_phone": "+15125550123",
"entity_type": "llc",
"formation_state": "TX",
"industry": "Manufacturing",
"website": "https://acmesupply.com",
"underwriting_status": "pending",
"seller_amount_approved": 50000,
"active_subscription": {
"id": "sub_1234567890abcdef",
"tier": "trial"
},
"document_ingestion": {
"requested_count": 2,
"queued_count": 1,
"failed_count": 1,
"results": [
{
"document_id": "md_1234567890abcdef"
}
]
},
"created_at": "2026-02-26T10:00:00.000Z",
"updated_at": "2026-02-26T10:05:00.000Z"
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.