Voice ToolsSpeech to Text

List Transcripts

Retrieve paginated transcript jobs for the authenticated team.

Endpoint

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

Query Parameters

ParameterTypeRequiredNotes
pageinteger❌Page number. Default: 1.
per_pageinteger❌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).