---
title: "retroactiveExtractions.estimate"
method: POST
path: "/capabilities/retroactiveExtractions.estimate"
tags: ["Capabilities"]
---

# retroactiveExtractions.estimate

`POST /capabilities/retroactiveExtractions.estimate`

Queue a Retroactive Scan estimate for the given email integration and date range. Returns a jobId immediately; poll with getRetroactiveExtractionEstimate. Estimation against a real mailbox can take minutes; use the poll capability rather than waiting.

## Request body

- object
  - `integrationId` string, required — The email integration ID to estimate against (use listIntegrations to find).
  - `fromDate` string, required — Inclusive start date in YYYY-MM-DD format.
  - `toDate` string, required — Inclusive end date in YYYY-MM-DD format.
  - `sendersPreference` 'allowed' | 'blocked', required — Whether the sender list is an allow-list or block-list.
  - `mailboxId` string — Mailbox/folder id to scope the estimate. Defaults to 'all'.

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