---
title: "merchants.list"
method: POST
path: "/capabilities/merchants.list"
tags: ["Capabilities"]
---

# merchants.list

`POST /capabilities/merchants.list`

List and search merchants with document counts, spend totals, currencies, and profile fields.

## Request body

- object
  - `search` string — Search term to filter merchants by name
  - `fromDate` string — Only include documents on or after this date
  - `toDate` string — Only include documents on or before this date
  - `currency` string — Only include documents in this source currency
  - `sortBy` 'name' | 'totalSpent' | 'count' | 'lastTransaction'
  - `page` integer — Page number
  - `limit` integer — Results per page

## Response `200`

Successful response

- object
  - `success` boolean
  - `code` integer
  - `data` object
    - `result` object — Capability-specific result

## Other responses

- `400` — Invalid input
- `401` — Authentication required
- `404` — Resource not found

---

[API](https://skmtc.net/receiptor/apis/receiptor-ai-api.md) · [All operations](https://skmtc.net/receiptor/apis/receiptor-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/receiptor/receiptor-ai-api/versions/da17f0eb65a2/schema)