Get a meeting's transcript

curl --request GET \
  --url https://api.myhamlet.com/v1/meetings/{uuid}/transcript \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.myhamlet.com/v1/meetings/{uuid}/transcript', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.myhamlet.com/v1/meetings/{uuid}/transcript",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.myhamlet.com/v1/meetings/{uuid}/transcript"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.myhamlet.com/v1/meetings/{uuid}/transcript")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "uuid": "d8e1f2a3-4b5c-6d7e-8f90-1a2b3c4d5e6f",
  "meeting_uuid": "9a1c...",
  "format": "jsonl",
  "coverage": "single",
  "part_count": 1,
  "rendition": null,
  "parts": [
    {
      "part": 1,
      "uuid": "d8e1f2a3-4b5c-6d7e-8f90-1a2b3c4d5e6f",
      "offset_seconds": 0,
      "duration_seconds": 7180,
      "download_url": "https://hamlet-transcripts-prod.s3.us-west-1.amazonaws.com/…?X-Amz-Signature=…",
      "url_expires_at": "2026-06-22T15:30:00.000Z",
      "generated_at": "2026-05-22T09:20:00.000Z"
    }
  ],
  "download_url": "https://hamlet-transcripts-prod.s3.us-west-1.amazonaws.com/…?X-Amz-Signature=…",
  "url_expires_at": "2026-06-22T15:30:00.000Z",
  "generated_at": "2026-05-22T09:20:00.000Z"
}

{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found."
  }
}

{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found."
  }
}

{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found."
  }
}

Meetings

Get a meeting's transcript

Returns metadata plus a short-lived (1-hour) presigned S3 URL to download the meeting’s transcript as a JSONL file (one utterance per line, no embeddings). Returns 404 if the meeting does not exist, your API key is not entitled to it, or it has no built transcript artifact (has_transcript on the meeting list tells you in advance). The link is never broken: a 200 always carries a valid, downloadable URL.

A meeting that recessed and reconvened is transcribed as several consecutive parts. Read coverage (or part_count) and use the parts array to get the whole meeting: the top-level download_url, url_expires_at and uuid describe parts[0] only, so a client that reads just those fields gets the first part of such a meeting — truthful, but partial, and with no error to signal it. Single-artifact meetings, which is nearly all of them, report coverage: "single" with one entry in parts.

GET

meetings

{uuid}

transcript

Get a meeting's transcript

curl --request GET \
  --url https://api.myhamlet.com/v1/meetings/{uuid}/transcript \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.myhamlet.com/v1/meetings/{uuid}/transcript', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.myhamlet.com/v1/meetings/{uuid}/transcript",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.myhamlet.com/v1/meetings/{uuid}/transcript"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.myhamlet.com/v1/meetings/{uuid}/transcript")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "uuid": "d8e1f2a3-4b5c-6d7e-8f90-1a2b3c4d5e6f",
  "meeting_uuid": "9a1c...",
  "format": "jsonl",
  "coverage": "single",
  "part_count": 1,
  "rendition": null,
  "parts": [
    {
      "part": 1,
      "uuid": "d8e1f2a3-4b5c-6d7e-8f90-1a2b3c4d5e6f",
      "offset_seconds": 0,
      "duration_seconds": 7180,
      "download_url": "https://hamlet-transcripts-prod.s3.us-west-1.amazonaws.com/…?X-Amz-Signature=…",
      "url_expires_at": "2026-06-22T15:30:00.000Z",
      "generated_at": "2026-05-22T09:20:00.000Z"
    }
  ],
  "download_url": "https://hamlet-transcripts-prod.s3.us-west-1.amazonaws.com/…?X-Amz-Signature=…",
  "url_expires_at": "2026-06-22T15:30:00.000Z",
  "generated_at": "2026-05-22T09:20:00.000Z"
}

{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found."
  }
}

{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found."
  }
}

{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found."
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

uuid

string<uuid>

required

The meeting's public uuid.

Example:

"9a1c2b3d-4e5f-6071-8293-a4b5c6d7e8f9"

Response

Transcript metadata with a 1-hour presigned download URL.

uuid

string

required

The transcript's public identifier.

Example:

"d8e1f2a3-4b5c-6d7e-8f90-1a2b3c4d5e6f"

meeting_uuid

string

required

The meeting's public identifier; matches the path.

Example:

"9a1c..."

format

enum<string>

required

The downloaded artifact's format. Always jsonl (one utterance object per line).

Available options:

jsonl

Example:

"jsonl"

coverage

enum<string>

required

Whether this meeting's transcript is one artifact (single) or several consecutive parts that must be read in order (multipart). Branch on this — or on part_count — before treating download_url as the complete meeting. Describes what parts actually contains rather than what the meeting was recorded as: a meeting known to have parts whose artifacts are not built yet reports single with a null rendition, because the one artifact returned cannot be attributed to that coverage.

Available options:

single,

multipart

Example:

"single"

part_count

integer

required

How many parts are available to download, i.e. the length of parts. Can be lower than the meeting's true part count while a later part's artifact is still being built, so a multipart response with part_count: 1 means 'more is coming', not 'this is all there is'.

Example:

1

rendition

integer | null

required

Which coverage of the meeting these parts come from, when a meeting has been recorded more than once (Granicus and YouTube, say). Null for a meeting with a single unnumbered recording, which is the overwhelming majority. Parts are never mixed across renditions.

Example:

null

parts

object[]

required

Every downloadable part, in reading order. Always present and never empty — a single-artifact meeting is one part. This is the authoritative list: the top-level download_url, url_expires_at and uuid describe parts[0] only.

Show child attributes

download_url

string

required

Presigned S3 URL for the JSONL transcript, valid 1 hour. Download it before it expires. Describes parts[0] only. For a multipart meeting this is the FIRST part, not the whole meeting — a client that reads only this field gets a truthful but partial transcript and no error. Use parts when coverage is multipart.

Example:

"https://hamlet-transcripts-prod.s3.us-west-1.amazonaws.com/…?X-Amz-Signature=…"

url_expires_at

string

required

ISO-8601 UTC timestamp when download_url expires. Describes parts[0].

Example:

"2026-06-22T15:30:00.000Z"

generated_at

string

required

ISO-8601 UTC timestamp for when the transcript artifact was built. The NEWEST across all parts, so it answers 'how fresh is this transcript?' for the meeting as a whole — unlike the other top-level fields, which describe parts[0].

Example:

"2026-05-22T09:20:00.000Z"

Get started

Guides

API reference

Get a meeting's transcript

Authorizations

Path Parameters

Response