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
  • email
  • 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

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.

countinteger
pageinteger
limitinteger

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.