DEVELOPER DOCUMENTATION
Get Interview Transcript
Read the full sanitized AI-interview transcript for a proposal, message by message.
GET
/api/public/v1/proposals/{proposalId}/interviewReturns the complete AI-interview transcript for a proposal — every exchange between the AI interviewer and the candidate, oldest first — plus the score and summary. Check aiInterview.transcriptAvailable on GET /proposals/{proposalId} first; this endpoint returns 404 when no interview is recorded.
Transcripts are sanitized before they leave the platform: contact details and other personal identifiers are scrubbed — see privacy.
Requirements: proposals:read scope. The proposal must be on a job you own (403 otherwise). Works pre-claim.
Request
Section titled “Request”proposalIdstringpathrequiredThe proposal ID.
Response
Section titled “Response”interviewobjectErrors
Section titled “Errors”| Status | code | Meaning |
|---|---|---|
400 | BAD_REQUEST | Missing proposalId |
401 | UNAUTHORIZED | Missing or invalid token |
403 | FORBIDDEN | Missing proposals:read scope, or the proposal is on another account’s job |
404 | NOT_FOUND | No such proposal, or no AI interview is recorded for this proposal (details.proposalId) |