List Transcripts

Retrieve paginated transcript jobs for the authenticated team.

Endpoint

GET https://app.resemble.ai/api/v2/speech-to-text

Query Parameters

Parameter	Type	Required	Notes
`page`	integer	❌	Page number. Default: 1.
`per_page`	integer	❌	Items per page (1-50). Default: 25.

Response

1 {
2   "success": true,
3   "meta": {
4     "page": 1,
5     "per_page": 25,
6     "total_pages": 4,
7     "total_items": 87
8   },
9   "items": [
10     {
11       "uuid": "550e8400-e29b-41d4-a716-446655440000",
12       "text": "Full transcript text...",
13       "words": [
14         {
15           "word": "Hello",
16           "start": 0.0,
17           "end": 0.5,
18           "confidence": 0.99
19         }
20       ],
21       "query": "Summarize the main points",
22       "answer": "The main points are...",
23       "status": "completed",
24       "file_url": "https://...",
25       "duration_seconds": 120.5,
26       "created_at": "2024-01-15T10:30:00Z",
27       "updated_at": "2024-01-15T10:32:00Z"
28     }
29   ]
30 }

Note: Status can be pending, processing, completed, or failed.

Examples

$ curl --request GET 'https://app.resemble.ai/api/v2/speech-to-text?page=1&per_page=10' \
>   -H 'Authorization: Bearer YOUR_API_TOKEN'

Filter completed jobs client-side with jq:

$ curl -s -H "Authorization: Bearer YOUR_API_TOKEN" \
>   "https://app.resemble.ai/api/v2/speech-to-text?per_page=50" \
>   | jq '.items[] | select(.status == "completed")'

Iterate through every page:

$ page=1
$ while true; do
$   response=$(curl -s -H "Authorization: Bearer YOUR_API_TOKEN" \
>     "https://app.resemble.ai/api/v2/speech-to-text?page=$page&per_page=50")
$ 
$   echo "$response" | jq '.items[]'
$ 
$   current=$(echo "$response" | jq '.meta.page')
$   total=$(echo "$response" | jq '.meta.total_pages')
$   [ "$current" -ge "$total" ] && break
$   page=$((page + 1))
$ done

Best Practices

Request only the fields you need and cache results locally when possible.
Poll at reasonable intervals to track status transitions without throttling the service.
Validate pagination parameters before sending requests.

Errors follow the standard { "success": false, "error": "..." } structure with appropriate HTTP status codes (400, 401, 403, 500).