discoveries

Merged discovery view (status + result when terminal).

get/api/v1/discoveries/{jobId}

Request

  • Base URL: https://api.prosp.cc
  • URL: https://api.prosp.cc/api/v1/discoveries/{jobId}
  • Auth: OAuth 2 (client credentials, token URL https://prosp-mcp-641053169627.auth.eu-central-1.amazoncognito.com/oauth2/token, scopes: mcp/execute)

Response

Always returns the current status; includes result once terminal (completed, failed, exhausted, or cancelled). A cancelled run's result carries the prospects it delivered before cancellation.

jobIdstring required

Id of this discovery.

icp_idstring

The saved ICP this discovery was started from (POST /api/v1/discoveries {"icpId": ...}), for billing attribution — the same value the matching credit-ledger rows carry, so a charge reconciles back to the ICP that caused it. Served on EVERY job surface (the progressive status, the merged discovery view, the finished result, and each entry of the discoveries list) from one reader, so a customer can attribute a run to its ICP without waiting for the run to finish or cross-referencing the ledger. ABSENT (field omitted, never an empty string) when the run was ad-hoc from inline criteria. Ids are scoped to the calling customer — the same namespace GET /api/v1/icps returns.

status'queued' | 'running' | 'processing' | 'completed' | 'failed' | 'exhausted' | 'cancelled' required

Discovery lifecycle state. queued = accepted, not yet started; running and processing = discovery in progress; completed = finished and reached its target; failed = ended with an error; exhausted = finished but ran out of candidates before hitting the target; cancelled = stopped by the caller via POST /mcp/jobs/{jobId}/cancel. The last four are terminal.

Example response

{
  "result": {
    "withheld_count": 1,
    "already_owned_count": 2,
    "already_owned_withheld_count": 11,
    "candidates_screened": 157,
    "evaluated_count": 195,
    "prospects": [
      {
        "domain": "acme.de"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.