Interviews

Get interview status and transcript

Returns the current status of an interview request and, once completed, its full transcript.

Poll this endpoint to check whether a contact has completed their interview. When status is "completed", the transcript field contains the full conversation content.

get/interviews/{id}

Request

Base URL
https://app.usehindsight.com/api/v1
Auth
HTTP bearer

Path parameters

idinteger required

The interview_request_id returned when the interview was created.

Response

Interview request found

interview_request_idinteger

ID of the interview request.

contact_idstring nullable

ID of the contact being interviewed.

deal_idstring nullable

Associated deal ID, or null.

survey_urlstring nullable

Direct link to the survey for this contact.

status'created' | 'sent' | 'completed'

created — request exists, no email sent yet. sent — email sent, awaiting the contact's response. completed — interview finished; transcript is populated.

objectivestring nullable

The interview-specific goal, if set.

email_sent_atstring date-time nullable

ISO timestamp when the outreach email was sent, or null.

created_atstring date-time

ISO timestamp when the interview request was created.

Example response

{
  "interview_request_id": 4821,
  "contact_id": "contact_abc123",
  "deal_id": "deal_xyz789",
  "survey_url": "https://app.usehindsight.com/survey?token=tok_xyz",
  "status": "sent",
  "objective": "Understand why we lost to Competitor X",
  "email_sent_at": "2026-05-15T10:00:00Z",
  "created_at": "2026-05-15T09:00:00Z",
  "transcript": {
    "document_id": "doc_abc123",
    "content": "**Paige:** Thanks for taking the time today...\n\n**Jane:** Happy to help...",
    "created_at": "2026-05-16T14:30:00Z"
  }
}

Changes

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