---
title: "Run Prospecting"
method: POST
path: "/api/prospecting/run"
tags: ["prospecting"]
---

# Run Prospecting

`POST /api/prospecting/run`

## Request body

- ProspectingRunRequest
  - `dry_run` boolean
  - `preview_limit` integer

## Response `200`

Successful Response

- union
  - ProspectingRunSummary
    - `dry_run` boolean, required
    - `batch_target` integer, required
    - `pages_fetched` integer, required
    - `apollo_people_seen` integer, required
    - `accepted` integer, required
    - `duplicates` integer, required
    - `excluded` integer, required
    - `skipped_missing_email` integer
    - `skipped_no_identifier` integer
    - `skipped_enrich_failed` integer
    - `companies_created` integer
    - `companies_updated` integer
    - `people_created` integer
    - `people_updated` integer
    - `external_identities_created` integer
    - `qualification_counts` object
    - `enrichment_actions_queued` integer
    - `apollo_credits_spent` integer
    - `apollo_credits_cap` integer
    - `apollo_credits_remaining` integer
    - `preview` ProspectPreviewPerson[]
      - `apollo_person_id` string, nullable
      - `apollo_org_id` string, nullable
      - `email` string, nullable
      - `has_email` boolean, nullable
      - `linkedin_url` string, nullable
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `title` string, nullable
      - `company_name` string, nullable
      - `company_domain` string, nullable
      - `prospecting_status` string, nullable
      - `qualification` object
    - `notes` string[]
  - ProspectingQueuedResponse
    - `queued` boolean
    - `action_id` string, uuid, required
    - `status` string, required
    - `dry_run` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/rethoric/apis/rethoric-os.md) · [All operations](https://skmtc.dev/rethoric/apis/rethoric-os/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rethoric/rethoric-os/revisions/76b6d39426f6/schema)