discoveries

List the caller's discoveries.

Newest-first page of the caller's discoveries. Page with limit (default 50, max 200) and offset. A limit outside 1–200, a negative or non-integer limit/offset, or any other query parameter, is rejected with 400 invalid_query.

get/api/v1/discoveries

Request

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

Query parameters

limitinteger

Maximum number of prospects to return per page (1–200; defaults to 50). A value outside the range is rejected with a 400, not clamped.

offsetinteger

Number of prospects to skip before the page starts, for offset pagination (defaults to 0).

Response

The caller's discoveries, with the canonical pagination envelope (total, count, offset, has_more) shared with the credit-ledger surface so a client pages every list surface the same way.

customer_idstring required

The authenticated customer these discoveries belong to.

countinteger required

Number of discoveries in THIS page (never exceeds the requested limit).

totalinteger required

Total discoveries for the caller (across all pages).

offsetinteger required

The starting index this page was served from (echoes the request offset).

has_moreboolean required

True when this page left discoveries unreturned — fetch the next with offset += count.

Example response

{
  "jobs": [
    {
      "total_prospects": 3,
      "withheld_count": 1,
      "candidates_screened": 157,
      "evaluated_count": 195,
      "stage": "screening",
      "last_activity_at": "2026-08-09T11:38:12.474Z",
      "seconds_since_last_activity": 45,
      "poll_after_seconds": 20,
      "estimated_duration_seconds": 2900,
      "estimated_duration_p50_seconds": 1140,
      "estimated_duration_p90_seconds": 2400,
      "estimated_duration_p95_seconds": 2900,
      "estimated_yield": 4,
      "already_owned_count": 2
    }
  ]
}

Changes

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