> ## Documentation Index
> Fetch the complete documentation index at: https://docs.techeval.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /transcripts/{id} — Retrieve Interview Transcript

> GET /transcripts/{candidate_id} — fetch the full question-and-answer transcript URL for any completed Kovi interview session for your review.

Use `GET /transcripts/{candidate_id}` to retrieve the full transcript URL for a completed interview. The transcript contains every question Kovi asked and the candidate's responses, giving you a verbatim record of the entire session.

**Endpoint**

```
GET https://api.techeval.ai/v1/transcripts/{candidate_id}
```

**Authentication:** Bearer token required — see [Authentication](/api-reference/authentication).

***

## Path Parameters

<ParamField path="candidate_id" type="string" required>
  The unique identifier of the candidate whose transcript you want to retrieve (e.g., `"cnd_98765"`). This is the same `candidate_id` found in the scorecard and webhook payload.
</ParamField>

***

## Example Request

```bash theme={null}
curl -X GET https://api.techeval.ai/v1/transcripts/cnd_98765 \
  -H "Authorization: Bearer YOUR_API_KEY"
```

***

## Response

A successful `200 OK` response returns the following fields:

<ResponseField name="candidate_id" type="string">
  The unique identifier of the candidate.
</ResponseField>

<ResponseField name="transcript_url" type="string">
  The URL to view the full interview transcript in the Techeval dashboard (e.g., `"https://techeval.ai/dash/transcripts/cnd_98765"`). The transcript displays every question asked by Kovi and every response given by the candidate.
</ResponseField>

<ResponseField name="duration_minutes" type="integer">
  The actual duration of the interview in minutes. This may be less than the configured maximum `duration` if the candidate completed all questions early.
</ResponseField>

<ResponseField name="completed_at" type="string">
  ISO 8601 timestamp indicating when the interview session ended (e.g., `"2025-09-12T15:04:32Z"`).
</ResponseField>

**Example response:**

```json theme={null}
{
  "candidate_id": "cnd_98765",
  "transcript_url": "https://techeval.ai/dash/transcripts/cnd_98765",
  "duration_minutes": 13,
  "completed_at": "2025-09-12T15:04:32Z"
}
```

<Info>
  Transcript URLs require a Techeval dashboard login to view. Share the URL with authorized team members who have access to your account.
</Info>

<Tip>
  Use transcripts to review proctoring-flagged interviews before making a hiring decision. If `ai_copilot_detected` or `tab_switches` are elevated in the scorecard, the transcript gives you the full context to assess whether the candidate's responses were genuinely their own.
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.