---
title: "activity.search"
method: POST
path: "/capabilities/activity.search"
tags: ["Capabilities"]
---

# activity.search

`POST /capabilities/activity.search`

Search past source activity logs across email, WhatsApp, uploads, and forwarded inbound email. For email sources, this first searches connected providers, then cross-checks matching message IDs against stored activity logs and returns any saved processing reasoning. Forwarded inbound email is matched directly against stored activity by its alias address.

## Request body

- object
  - `query` string, required — Natural-language or exact search query such as merchant, sender, or invoice keyword.
  - `sourceTypes` string[] — Which source activity types to search.
  - `statuses` string[] — Optional activity statuses to include.
  - `page` integer — Page number for paginated results.
  - `limit` integer — Maximum number of activity items to return.
  - `includeSourceDetails` boolean — Whether to reload matching provider messages for richer email details like subject, sender, and snippet.
  - `providerResultLimit` integer — Maximum number of provider search matches to cross-check before filtering activity logs.

## 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)