---
title: "notetakerTranscript.info"
method: POST
path: "/notetakerTranscript.info"
tags: ["Notetaker Transcript"]
---

# notetakerTranscript.info

`POST /notetakerTranscript.info`

Fetches metadata and a pre-signed download URL for an AI
Notetaker transcript recording.

**Prerequisites:**
- Your organization must have the **AI Notetaker add-on**. If your organization does not have
  the add-on, requests will fail with the `notetaker_transcript_not_enabled` error.

The response includes a signed URL with the transcript JSON. Download the file promptly after calling
  this endpoint. If the URL has expired, call the endpoint again to get a fresh one.

On the free tier, transcripts expire after a retention period. Requesting an expired
transcript returns the `notetaker_transcript_expired` error. Organizations with unlimited
AI Notetaker access are not subject to this expiry.

Use the `notetakerTranscriptId` field from
[`interviewEvent.list`](https://developers.ashbyhq.com/reference/intervieweventlist) or [`interviewSchedule.list`](https://developers.ashbyhq.com/reference/interviewschedulelist) to discover
transcript IDs for interview events.

**Error codes:**

| Code | Description |
|---|---|
| `notetaker_transcript_not_enabled` | Your organization does not have the AI Notetaker add-on. |
| `notetaker_transcript_not_found` | No transcript exists with the given ID, or you do not have access to it. |
| `notetaker_transcript_expired` | The transcript has expired. Upgrade to unlimited AI Notetaker to retain transcripts indefinitely. |
| `invalid_input` | The provided `notetakerTranscriptId` is not a valid UUID. |

Configure API key permissions in **Admin → API Keys**. See [Managing API Key Permissions](authentication#managing-api-key-permissions).

**Requires the [`notetakerRead`](authentication#permissions-notetakertranscriptinfo) permission.**

## Request body

- NotetakerTranscriptInfoRequest
  - `notetakerTranscriptId` string, uuid, required — The unique id of the notetaker transcript to fetch

## Response `200`

Responses from the notetakerTranscript.info endpoint

- union
  - NotetakerTranscriptInfoSuccessResponse
    - `success` true, required
    - `results` NotetakerTranscript, required
      - `id` string, uuid, required — The unique id of the notetaker transcript recording
      - `interviewEventId` string, uuid, nullable, required — The id of the interview event this transcript is associated with
      - `interviewScheduleId` string, uuid, nullable, required — The id of the interview schedule this transcript is associated with
      - `createdAt` string, date-time, required — The time the transcript recording was created
      - `participants` Participant[], required — The participants in the interview, resolved from the interview schedule. Includes interviewers and the candidate.
        - `id` string, uuid, required — The id of the participant. For interviewers, this is the Ashby user id. For candidates, this is the candidate id.
        - `type` 'interviewer' | 'candidate', required — Whether this participant is an interviewer or the candidate
        - `name` string, required — The display name of the participant
        - `email` string, nullable, required — The primary email address of the participant, or null if not available
      - `transcriptUrl` string, required — A signed URL to download the transcript JSON. The URL expires after 5 minutes. Download promptly after receiving the response. If the URL has expired, call the endpoint again to get a fresh one.
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

[API](https://skmtc.net/ashbyhq/apis/ashby-api.md) · [All operations](https://skmtc.net/ashbyhq/apis/ashby-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ashbyhq/ashby-api/revisions/778b919dc743/schema)