List transcript segments
curl --request GET \
--url https://api.rask.ai/v3/projects/{project_id}/segments \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.rask.ai/v3/projects/{project_id}/segments"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.rask.ai/v3/projects/{project_id}/segments', 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.rask.ai/v3/projects/{project_id}/segments",
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.rask.ai/v3/projects/{project_id}/segments"
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))
}HttpResponse<String> response = Unirest.get("https://api.rask.ai/v3/projects/{project_id}/segments")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.rask.ai/v3/projects/{project_id}/segments")
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{
"object": "list",
"data": [
{
"object": "segment",
"id": "5f0e2c7a-1b3d-4e6f-8a9c-2d4e6f8a0b11",
"project_id": "6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
"start_seconds": 0,
"end_seconds": 3.2,
"speaker_id": "SPEAKER_00",
"speaker_label": "Speaker 1",
"source": {
"text": "Welcome to our Q3 webinar.",
"language": "en"
},
"translation": {
"text": "Bienvenidos a nuestro webinar del tercer trimestre.",
"language": "es-es"
},
"words": null,
"needs_attention": false,
"status": "ready",
"dub_state": "current",
"audio": {
"url": "https://storage.example.com/5f0e2c7a-1b3d-4e6f-8a9c-2d4e6f8a0b11.wav?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=3b9f0c",
"expires_at": "2026-11-03T11:15:02Z",
"duration_seconds": 3.2
},
"selected_variant_id": null,
"translation_variants": null,
"processing_started_at": null,
"etag": "\"s-ba9e012612afb8c7\""
},
{
"object": "segment",
"id": "8b3d1e9f-6a2c-4d7e-b5f1-3c9e7a1d5b22",
"project_id": "6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
"start_seconds": 3.4,
"end_seconds": 6.8,
"speaker_id": "SPEAKER_01",
"speaker_label": "Speaker 2",
"source": {
"text": "Today we cover the new dubbing features.",
"language": "en"
},
"translation": {
"text": "Hoy repasamos las nuevas funciones de doblaje.",
"language": "es-es"
},
"words": null,
"needs_attention": false,
"status": "ready",
"dub_state": "outdated",
"audio": null,
"selected_variant_id": null,
"translation_variants": null,
"processing_started_at": null,
"etag": "\"s-a197265875140819\""
},
{
"object": "segment",
"id": "2c7e9a4f-3d1b-4f8e-a6c2-9b5d1f3e7a33",
"project_id": "6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
"start_seconds": 7,
"end_seconds": 9.6,
"speaker_id": "SPEAKER_00",
"speaker_label": "Speaker 1",
"source": {
"text": "Let's get started.",
"language": "en"
},
"translation": {
"text": "Empecemos.",
"language": "es-es"
},
"words": null,
"needs_attention": false,
"status": "ready",
"dub_state": "current",
"audio": {
"url": "https://storage.example.com/2c7e9a4f-3d1b-4f8e-a6c2-9b5d1f3e7a33.wav?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=3b9f0c",
"expires_at": "2026-11-03T11:15:02Z",
"duration_seconds": 2.6
},
"selected_variant_id": null,
"translation_variants": null,
"processing_started_at": null,
"etag": "\"s-6a45f87e138e55ae\""
}
],
"next_cursor": null,
"has_more": false
}Segments
List transcript segments
Lists segments in start-time order with texts, speaker, status.
GET
/
projects
/
{project_id}
/
segments
List transcript segments
curl --request GET \
--url https://api.rask.ai/v3/projects/{project_id}/segments \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.rask.ai/v3/projects/{project_id}/segments"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.rask.ai/v3/projects/{project_id}/segments', 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.rask.ai/v3/projects/{project_id}/segments",
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.rask.ai/v3/projects/{project_id}/segments"
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))
}HttpResponse<String> response = Unirest.get("https://api.rask.ai/v3/projects/{project_id}/segments")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.rask.ai/v3/projects/{project_id}/segments")
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{
"object": "list",
"data": [
{
"object": "segment",
"id": "5f0e2c7a-1b3d-4e6f-8a9c-2d4e6f8a0b11",
"project_id": "6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
"start_seconds": 0,
"end_seconds": 3.2,
"speaker_id": "SPEAKER_00",
"speaker_label": "Speaker 1",
"source": {
"text": "Welcome to our Q3 webinar.",
"language": "en"
},
"translation": {
"text": "Bienvenidos a nuestro webinar del tercer trimestre.",
"language": "es-es"
},
"words": null,
"needs_attention": false,
"status": "ready",
"dub_state": "current",
"audio": {
"url": "https://storage.example.com/5f0e2c7a-1b3d-4e6f-8a9c-2d4e6f8a0b11.wav?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=3b9f0c",
"expires_at": "2026-11-03T11:15:02Z",
"duration_seconds": 3.2
},
"selected_variant_id": null,
"translation_variants": null,
"processing_started_at": null,
"etag": "\"s-ba9e012612afb8c7\""
},
{
"object": "segment",
"id": "8b3d1e9f-6a2c-4d7e-b5f1-3c9e7a1d5b22",
"project_id": "6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
"start_seconds": 3.4,
"end_seconds": 6.8,
"speaker_id": "SPEAKER_01",
"speaker_label": "Speaker 2",
"source": {
"text": "Today we cover the new dubbing features.",
"language": "en"
},
"translation": {
"text": "Hoy repasamos las nuevas funciones de doblaje.",
"language": "es-es"
},
"words": null,
"needs_attention": false,
"status": "ready",
"dub_state": "outdated",
"audio": null,
"selected_variant_id": null,
"translation_variants": null,
"processing_started_at": null,
"etag": "\"s-a197265875140819\""
},
{
"object": "segment",
"id": "2c7e9a4f-3d1b-4f8e-a6c2-9b5d1f3e7a33",
"project_id": "6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
"start_seconds": 7,
"end_seconds": 9.6,
"speaker_id": "SPEAKER_00",
"speaker_label": "Speaker 1",
"source": {
"text": "Let's get started.",
"language": "en"
},
"translation": {
"text": "Empecemos.",
"language": "es-es"
},
"words": null,
"needs_attention": false,
"status": "ready",
"dub_state": "current",
"audio": {
"url": "https://storage.example.com/2c7e9a4f-3d1b-4f8e-a6c2-9b5d1f3e7a33.wav?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=3b9f0c",
"expires_at": "2026-11-03T11:15:02Z",
"duration_seconds": 2.6
},
"selected_variant_id": null,
"translation_variants": null,
"processing_started_at": null,
"etag": "\"s-6a45f87e138e55ae\""
}
],
"next_cursor": null,
"has_more": false
}Lists segments in start-time order with texts, speaker, status (
ready, translating, voicing, translation_failed), dub state (not_dubbed, current, outdated), audio link and ETag. Filters: ids, text (q), speaker, status, dub state, review flag, time window; include=words,variants adds word timings and translation variants.
When to use: to read or search the transcript. If the transcript is replaced (restore, subtitle import) a cursor fails with transcript_replaced: restart.
Side effects: None.
Cost: Free.
Idempotency: safe and pure (never writes); retry freely.
Pagination: limit (default 100, max 500) and cursor; follow next_cursor until has_more is false.
Paid text: on a project created through v3, 409 dub_payment_required until a dub of that project is charged.
Required scopes: transcripts:read
Errors: transcript_not_ready (409), transcript_replaced (409), dub_payment_required (409)Authorizations
API key from Settings -> API keys, sent as Authorization: Bearer <key> (SDK environment variable RASK_API_KEY). Bound to one workspace and one acting user. Operations list the scopes they need (OpenAPI 3.1 scopes on a bearer scheme).
Scopes
transcripts:read
Path Parameters
Project id (from createProject or listProjects).
Maximum string length:
64Query Parameters
Page size.
Required range:
1 <= x <= 500Opaque cursor from next_cursor; keep the same filters on every page.
Maximum string length:
2048Up to 100 segment ids.
Required array length:
1 - 100 elementsMaximum string length:
64Only this speaker.
Maximum string length:
11Pattern:
^SPEAKER_\d{2,3}$Comma-separated statuses.
Maximum array length:
4Segment processing status.
ready: editabletranslating: a translation is runningvoicing: a segment generation is voicing ittranslation_failed: the last translation failed
Available options:
ready, translating, voicing, translation_failed Comma-separated dub states.
Maximum array length:
3Dub state of a segment.
not_dubbed: the project has no dub of this segmentcurrent: the dub matches the segmentoutdated: the next changed_segments dub includes it: voiced, or merged from its current clip
Available options:
not_dubbed, current, outdated Only flagged (true) or unflagged (false) segments.
Segments overlapping [from_seconds, to_seconds).
Required range:
x >= 0End of the time window.
Required range:
x >= 0Only segments whose source or translation text contains this text (1-100 characters, case-insensitive).
Required string length:
1 - 100Optional fields to fill: words, variants (comma-separated).
Maximum array length:
2Optional segment fields.
words: word timingsvariants: translation variants
Available options:
words, variants Response
OK: SegmentList.
A page of Segment (the list envelope shared by every list).
Always list.
Available options:
list Items of this page.
Show child attributes
Show child attributes
Pass as cursor for the next page; null on the last page.
More items exist (a page may hold fewer than limit items while has_more is true).