Prospect result
One versioned representation shared by the project feed, every API read and every prospect webhook payload.
Schema version 2026-08-01. Identifiers are opaque strings (prospect_4815, not 4815).
A field the prospect has no answer for is null or an empty collection. Omission means one thing only: an expansion you did not ask for.
Fields
| Field | Type | Meaning |
|---|---|---|
| object | string | Always prospect. |
| id | string | Opaque prospect identifier, prospect_<n>. |
| project | object | Project id, name, current offering revision, stage executors. |
| company | object | Prospex company id, Swiss UID, name and registrable domain. UID and domain are null when not on file. |
| external_references | array | The {system, type, id} triples you supplied. Returned unchanged and never promoted into shared company data. |
| provenance | array | Every reason this company is in the project, current and historical, with the source and its effective date. |
| account_relationships | array | Your own effective relationships for this company, such as former_customer. |
| selection | object | Selection state, pin, exclusion, disposition, categorical priority and selection reason codes. |
| fit | object | The qualification outcome, its readable reasons, its priority and the executor that produced it. |
| stage_job | object|null | The open external job for this company: id, stage, status and deadline. Null when none is open. |
| research | object|null | The current research revision. Null before any research. |
| research.facts | array | Sourced statements, each with the evidence keys that back it. |
| research.interpretation | object | The angle, and the observations research marked as interpretive. |
| research.evidence | array | One record per cited page: id, url, title, supported fact, dates and access time. |
| research.evidence_verification | string | prospex_verified when Prospex fetched every cited page itself. unverified_external when a submitted revision cites a page Prospex has no copy of. |
| recommendations.buying_functions | array | Who typically buys this offering, as you named it when defining the offering. Always labelled interpretation: true. |
| outreach | object|null | The current outreach revision, with the copy, its claims and its approval state. |
| outreach.subject | string | The subject as a recipient reads it. Inline evidence markers are removed on every machine surface. |
| outreach.content_fingerprint | string | The value an approval must name. Approving without it approves whatever is current. |
| outreach.approval | object|null | Null until a specific revision is approved. Never set by a stage-result submission. |
| created_at | string | ISO 8601 UTC. |
| updated_at | string | ISO 8601 UTC. The column ?updated_since pages on. |
| history | object | Only present when you asked for ?include=history. Every research and outreach revision. |