# List merchants

Endpoint: GET /v1/merchants
Version: 2.0.0
Security: oAuth2

## Query parameters:

  - `status` (string)
    Enum: "active", "suspended", "pending_review"

  - `limit` (integer)

  - `cursor` (string)

## Response 200 fields (application/json):

  - `items` (array)

  - `items.merchantId` (string, required)
    Example: "mrc_01JH..."

  - `items.name` (string, required)

  - `items.country` (string, required)

  - `items.mcc` (string, required)

  - `items.status` (string, required)
    Enum: "active", "suspended", "pending_review"

  - `items.address` (object)

  - `items.address.line1` (string)

  - `items.address.city` (string)

  - `items.address.state` (string)

  - `items.address.postalCode` (string)

  - `items.createdAt` (string, required)

  - `pagination` (object)

  - `pagination.nextCursor` (string,null)
    Example: "cursor_abc123"