Skip to content
/Merchants

Merchants

Merchant-scoped operations for managing sub-merchant resources.

The merchant document upload endpoint creates a document record and starts transfer into Resolve-managed storage for validation.

Operations

List Merchants

Request

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
  • name
  • legal_name
  • email
  • underwriting_status
  • created_at

Supported sort fields:

  • created_at
  • id
  • name
  • legal_name

Use - prefix for descending sort, for example sort=-name.

Security
bearerAuth or basicAuth
Query
limitinteger, [ 1 .. 100 ]

Maximum number of merchants to return.

Default:25
Example:limit=25
pageinteger, >= 1

Page number for paginated merchant results.

Default:1
Example:page=1
searchstring

Case-insensitive text search across merchant id, name, email, and legal_name.

Example:search=alpha
sortstring

Sort field for merchant results.

Prefix with - for descending order.

Enum:"created_at""-created_at""id""-id""name""-name""legal_name""-legal_name"
Example:sort=-created_at
filterobject

Filter merchants by allowlisted fields.

Filter semantics: filter[field][operator]=value.

Supported filters:

  • filter[id][eq]=mrc_1234567890abcdef
  • filter[legal_name][eq]=Alpha Supply LLC
  • filter[underwriting_status][eq]=pending
  • filter[created_at][eq]=2026-03-11T00:00:00.000Z
curl -i -X GET \
  'https://docs.resolvepay.com/_mock/partners-api/openapi/merchants?limit=25&page=1&search=alpha&sort=-created_at&filter=%7B%22id%22%3A%7B%22eq%22%3A%22string%22%7D%2C%22external_id%22%3A%7B%22eq%22%3A%22string%22%7D%2C%22name%22%3A%7B%22eq%22%3A%22string%22%7D%2C%22legal_name%22%3A%7B%22eq%22%3A%22string%22%7D%2C%22email%22%3A%7B%22eq%22%3A%22user%40example.com%22%7D%2C%22underwriting_status%22%3A%7B%22eq%22%3A%22string%22%7D%2C%22created_at%22%3A%7B%22eq%22%3A%222019-08-24T14%3A15%3A22Z%22%7D%7D' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Paginated list of merchants.

Bodyapplication/json
countinteger
Example:2
pageinteger
Example:1
limitinteger
Example:25
resultsArray of objects(Merchant)
Response
{
  "count": 2,
  "page": 1,
  "limit": 25,
  "results": [
    { … },
    { … }
  ]
}