discovery

Download a finished job's sales report.

Renders the job's sales report on request: the same document the Telegram bot sends when a job completes (executive summary, immediate actions, one outreach draft per delivered prospect, and the prospect table), without going through the bot. Read-only: it starts no job, sends nothing to Telegram and changes nothing about the job.

Credits. Free. Fetching the report is a read of a document the job's own charge already covers, so it neither debits credits nor takes an Idempotency-Key. It is subject to the standard per-customer rate limit (100 requests / 60 s). The first request for a language the job has not been rendered in yet may take longer (up to a few minutes for a large cohort), because the report text is written then and cached for later requests.

Formats. format=pdf (default) returns application/pdf; format=html returns the self-contained HTML page the PDF is rendered from (text/html), which is convenient for reading or asserting on the text without a PDF parser.

Language. lang is an ISO 639-1 code from the supported set below. Default: the language the job was started in, else en. Company and person names are never translated.

Availability. Only a completed or exhausted job that delivered at least one prospect has a report; any other state answers 409 report_not_available. A job that belongs to another tenant, a job id that does not exist and a job that has expired all answer the same 403 not_owner at the gateway, so an id's existence is never confirmed.

Cost controls. Only generating a report that is not cached yet costs anything. Concurrent requests for the same report share one generation: the others wait briefly, then are served, or answer 409 report_rendering with Retry-After. A customer's newly generated reports are capped per UTC day (429 report_quota_exceeded, Retry-After); already generated reports stay available. A generation that fails does not use up the daily limit, and requests that were waiting on it are told at once (502 render_failed, Retry-After). If report generation is temporarily unavailable it answers 503 report_gate_unavailable with Retry-After instead of starting an unguarded generation.

get/mcp/jobs/{jobId}/report.pdf

Request

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

Query parameters

format'pdf' | 'html'

Response format.

lang'en' | 'uk' | 'de' | 'es' | 'fr' | 'it' | 'nl' | 'pl' | 'cs' | 'no' | 'fi' | 'he' | 'zh' | 'ko'

Report language (ISO 639-1). Defaults to the job's own language, else en. Any other value answers 400 unsupported_language.

Response

The report.

Changes

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