---
title: "Get stored candidate feedback"
method: GET
path: "/api/public/v1/interviews/{interview_id}/candidate-feedback"
tags: ["Public API v1 — Candidate Feedback", "Public API v1 — Candidate Feedback"]
---

# Get stored candidate feedback

`GET /api/public/v1/interviews/{interview_id}/candidate-feedback`

## Request

- Base URL: `https://api.thebetterhire.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebetterhire.ai/api/public/v1/interviews/{interview_id}/candidate-feedback`
- Auth: HTTP bearer

The feedback stored by the POST, unchanged. 404 `FEEDBACK_NOT_GENERATED` when the POST was never made, or when the interview has been re-analysed since (the stored pointers would no longer index the current scorecard). 409 `FEEDBACK_IN_PROGRESS` with `Retry-After` while a generation is running, including a regenerate with an older result stored: wait and GET again, don't POST again.

## Path parameters

- `interview_id` string, required

## Response `200`

Successful Response

- CandidateFeedbackResult: The stored and returned object.
  - `interview_id` string, required
  - `status` 'ready' | 'unavailable', required
  - `generated_at` string, nullable
  - `unavailable_reason` 'not_scored' | 'generation_failed', nullable
  - `feedback` CandidateFeedback: The stored/returned pieces: the draft plus the reserved field and, from contract 2.0, the story list.
    - `gap` string, required
    - `habit` HabitFeedback, required
      - `title` string, required
      - `explanation` string, required
      - `ref` EvidenceRef, required: Points at one quote on the public scorecard.
        - `competency` string, required: Competency name exactly as on the scorecard.
        - `evidence` integer, required: Index into that competency's evidence[].
    - `best_moment` BestMoment, required
      - `title` string, required
      - `ref` EvidenceRef, required: Points at one quote on the public scorecard.
        - `competency` string, required: Competency name exactly as on the scorecard.
        - `evidence` integer, required: Index into that competency's evidence[].
    - `competency_lines` CompetencyLine[], required
      - `name` string, required
      - `line` string, required
    - `heard` string, nullable
    - `rewrite` string, nullable
    - `structure` Structure: The story list: each story's framework parts, told unprompted (`present`), only after the interviewer asked (`when_asked`), or never (`missing`).
      - `status` 'ready' | 'not_applicable' | 'unavailable', required
      - `reason` 'skill_round' | 'generation_failed', nullable
      - `style` string, nullable
      - `parts` string[]
      - `stories` Story[]
        - `question` string, required
        - `competency` string, nullable
        - `ref` TurnRef, required: A span of `GET /interviews/{id}` → `transcript.segments[]`.
          - `first_turn` integer, required
          - `last_turn` integer, required
          - `start_seconds` number, required
          - `end_seconds` number, required
        - `present` string[], required
        - `when_asked` string[], required
        - `missing` string[], required
        - `note` string, required
      - `pattern` string, nullable
      - `openings` Opening[]
        - `kind` 'introduction' | 'motivation', required
        - `question` string, required
        - `ref` TurnRef, required: A span of `GET /interviews/{id}` → `transcript.segments[]`.
          - `first_turn` integer, required
          - `last_turn` integer, required
          - `start_seconds` number, required
          - `end_seconds` number, required
        - `seconds_spoken` integer, required
        - `focus` 'on_role' | 'partly' | 'wandered', required
        - `note` string, required
      - `transcript_fingerprint` string, nullable
  - `contract_version` string
  - `scorecard_fingerprint` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api.md) · [All operations](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/revisions/c8ad03e900ea?raw)