---
title: "List Merchants"
method: GET
path: "/merchants"
tags: ["Merchants"]
---

# List Merchants

`GET /merchants`

## Request

- Base URL: `https://app-sandbox.resolvepay.com/api`
- URL: `https://app-sandbox.resolvepay.com/api/merchants`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
- TypeScript: <https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference/docs/merchants/get.ts> (a function with typed inputs; its response is checked against the schema)

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`.

## Query parameters

- `limit` integer
- `page` integer
- `search` string
- `sort` 'created_at' | '-created_at' | 'id' | '-id' | 'name' | '-name' | 'legal_name' | '-legal_name'
- `filter` object
  - `id` object
    - `eq` string
  - `external_id` object
    - `eq` string
  - `reference_id` object
    - `eq` string: Partner-supplied identifier stored on the merchant.
  - `name` object
    - `eq` string
  - `legal_name` object
    - `eq` string
  - `email` object
    - `eq` string, email
  - `underwriting_status` object
    - `eq` string: Current latest underwriting status for the merchant.
  - `created_at` object
    - `eq` string, date-time

## Response `200`

Paginated list of merchants.

- MerchantList
  - `count` integer
  - `page` integer
  - `limit` integer
  - `results` Merchant[]
    - `id` string: Resolve merchant identifier (lowercase alphanumeric). For partner API create flows, ID assignment behavior is: - Resolve may derive a human-friendly alphanumeric candidate from merchant naming fields. - If the candidate collides with an existing merchant ID, Resolve generates a random lowercase alphanumeric ID.
    - `reference_id` string, nullable: Partner-supplied identifier for this merchant in your own system. `null` when never set.
    - `legal_business_name` string
    - `dba_name` string, nullable
    - `business_address` Address
      - `line1` string, required
      - `line2` string, nullable
      - `city` string, required
      - `state` string, required
      - `postal_code` string, required
      - `country` string, required
    - `business_email` string, email
    - `business_phone` string
    - `entity_type` 'corporation' | 'llc' | 'sole_proprietorship' | 'partnership' | 'non_profit'
    - `formation_state` string
    - `industry` string, nullable
    - `website` string, uri, nullable
    - `underwriting_status` string: Current underwriting lifecycle status for the merchant.
    - `seller_amount_approved` integer, nullable: Merchant approved limit (MAL), when available.
    - `active_subscription` object, nullable
      - `id` string
      - `tier` string
    - `metadata` object
    - `document_ingestion` DocumentIngestionSummary
      - `requested_count` integer
      - `queued_count` integer
      - `failed_count` integer
      - `results` DocumentIngestionResult[]
        - `document_id` string, nullable
        - `document_type` 'bank_statements' | 'financial_statements' | 'credit_references' | 'personal_guarantee' | 'other'
        - `filename` string
        - `download_url` string, uri
        - `status` 'queued' | 'failed'
        - `error_code` string, nullable
        - `error_message` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `400`: Bad request error
- `401`: Unauthorized error
- `429`: Rate limit error

---

[API](https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference.md) - [All operations](https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/resolvepay/apis/resolve-partners-api-reference/revisions/5a1c75b8b404?raw)