--- title: "Get report evidence" method: GET path: "/api/v1/reports/{id}/result" tags: ["Reports"] --- # Get report evidence `GET /api/v1/reports/{id}/result` ## Request - Base URL: `https://app.probbai.com` - URL: `https://app.probbai.com/api/v1/reports/{id}/result` - Auth: HTTP bearer Retrieve the versioned resume evaluation for an evidence-based review in your application. This includes rubric findings, supporting evidence, gaps, and follow-up questions. ## Before you call Use reports:read and schemaVersion=1 (the default). Wait for a completed report or a report.result_ready event. **Required scope:** `reports:read`. ## What happens next Save resultRevision with the resource and attempt IDs. Read scoreScale, limitations, and evidence before displaying a score. A pending or failed report has result=null. Text and lists are bounded. ## Recovery RESULT_VERSION_UNSUPPORTED means request a supported schema version. Missing measurements are unknown, not zero. A 404 after a deletion event is expected; stop polling that resource. [Follow the complete workflow](/integration-results/) · [Errors and retries](/api-errors/) ## Path parameters - `id` string, required ## Query parameters - `schemaVersion` '1' ## Response `200` Save resultRevision with the resource and attempt IDs. Read scoreScale, limitations, and evidence before displaying a score. A pending or failed report has result=null. Text and lists are bounded. - object - `data` RichResult, required - `schemaVersion` 1, required: Public payload format version. Result requests currently support 1; this is independent of the assigned product version. - `reportId` string, required: Report ID returned by upload preparation, admission, discovery, or an event. It must belong to the API key's workspace. - `attemptId` string, nullable, required: Analysis run identity. Retries keep this ID; a new admitted run receives a new ID. Null when no run is available. - `reportSystemVersion` string, nullable, required: Assigned report version used by the quote or analysis. Can be null for a legacy report. - `resultRevision` string, nullable, required: Identity of the result publication. Store it with resource and attempt IDs to detect a changed evaluation; null before publication. - `publishedAt` string, date-time, nullable, required: UTC result publication time when available; null for unpublished or legacy data without a publication timestamp. - `status` 'awaiting_upload' | 'queued' | 'processing' | 'requires_action' | 'completed' | 'failed', required: Current state of the surrounding resource or finding. Use the documented enum and the operation's workflow explanation. - `code` 'ANALYSIS_FAILED' | 'RESULT_UNAVAILABLE' | 'CANDIDATE_JOB_MISMATCH' | 'UNSUPPORTED_REPORT_VERSION', nullable, required: Stable machine-readable outcome or error code; null when no code applies. - `externalReference` object, nullable, required: Your application identity: source plus id, unique within the workspace. Prefer an application ID rather than personal information. - `source` string, required: Lowercase external-system slug, such as my-ats. Combined with id to identify one application in the workspace. - `id` string, required: Resource identifier. External-reference IDs are supplied by your system; resource/event IDs are returned by ProBB AI. - `result` object, nullable, required: Public evaluation. Null when unavailable, pending, or failed; inspect status rather than interpreting null as a zero score. - `scoreScale` object, required: Minimum and maximum values used for the report score. - `minimum` 0, required: Lower bound of the displayed score scale (0). - `maximum` 10, required: Upper bound of the displayed score scale (10). - `score` number, nullable, required: Evidence score from 0 to 10, or null when unavailable. It is not a probability of hiring success. - `summary` string, nullable, required: Concise explanation of the result or finding; null when unavailable. - `scoreReasoning` string, nullable, required: Explanation of the evidence supporting the score, or null if unavailable. - `humanReviewRecommendation` string, nullable, required: Suggested next review step based on the evidence and its limitations. - `rubric` object[], required: Criterion-by-criterion resume assessment, including scores, evidence, and missing information. - `key` string, required: Stable rubric criterion identifier within the returned evaluation. - `label` string, required: Human-readable name of this criterion or finding. - `status` 'positive' | 'neutral' | 'concern' | 'negative', required: Current state of the surrounding resource or finding. Use the documented enum and the operation's workflow explanation. - `score` number, nullable, required: Evidence score from 0 to 10, or null when unavailable. It is not a probability of hiring success. - `analysis` string, nullable, required: Explanation of the evidence for this rubric criterion. - `evidence` string[], required: Selected supporting observations. The API excludes raw transcripts, recordings, and original documents. - `gaps` string[], required: Requirements or supporting evidence not established by the available material. - `highlights` object[], required: Selected technical and role-fit findings; review their status and supporting context. - `category` 'technicalCore' | 'strategicFit', required: Grouping of a highlight: technicalCore or strategicFit. - `label` string, required: Human-readable name of this criterion or finding. - `status` 'positive' | 'neutral' | 'concern' | 'negative', required: Current state of the surrounding resource or finding. Use the documented enum and the operation's workflow explanation. - `summary` string, nullable, required: Concise explanation of the result or finding; null when unavailable. - `followUpQuestions` object, required: Suggested questions grouped by technical evidence, clarification, and risk review. - `technical` string[], required: Follow-up questions about role-related technical capabilities. - `clarification` string[], required: Questions to clarify incomplete or ambiguous resume evidence. - `riskReview` string[], required: Questions to investigate job-related concerns before acting on the report. - `integrity` object, required: Evidence-quality and identity-review signals, not a determination of candidate dishonesty. - `riskLevel` 'low' | 'medium' | 'high', nullable, required: Severity of integrity concerns, or null when the assessment is unavailable. - `summary` string, nullable, required: Concise explanation of the result or finding; null when unavailable. - `signals` object[], required: Individual integrity findings with evidence and suggested follow-up. - `kind` string, required: Variant selector. For job input use text or existing; for batches identifies uploads, analyses, or interviews. - `severity` 'low' | 'medium' | 'high', required: Priority of this integrity signal: low, medium, or high. - `evidence` string, nullable, required: Selected supporting observations. The API excludes raw transcripts, recordings, and original documents. - `recommendation` string, nullable, required: Suggested human follow-up or advisory outcome, as appropriate to the surrounding finding. - `policyWarnings` string[], required: Assessment policy limitations to consider during human review. - `ignoredCriteria` string[], required: Job criteria excluded from assessment. Do not treat these as evidence against a candidate. ## Other responses - `400`: Invalid input or cursor - `401`: Invalid, expired, or revoked API key - `403`: Disabled organisation or missing scope - `404`: The resource is absent, expired, deleted, or unavailable in this workspace. Verify the resource ID and key's workspace. - `405`: Method not allowed; consult Allow for supported methods - `429`: Request limit exceeded - `500`: Unexpected failure - `503`: Service unavailable --- [API](https://skmtc.dev/probbai/apis/probb-ai-customer-api.md) · [All operations](https://skmtc.dev/probbai/apis/probb-ai-customer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/probbai/apis/probb-ai-customer-api/revisions/33a3294530e4?raw)