GET
/
v2
/
transcription
Get transcription jobs based on query parameters
curl --request GET \
  --url https://api.gladia.io/v2/transcription \
  --header 'x-gladia-key: <api-key>'
{
  "first": "https://api.gladia.io/v2/transcription?status=done&offset=0&limit=20",
  "current": "https://api.gladia.io/v2/transcription?status=done&offset=0&limit=20",
  "next": "https://api.gladia.io/v2/transcription?status=done&offset=20&limit=20",
  "items": [
    {
      "id": "45463597-20b7-4af7-b3b3-f5fb778203ab",
      "request_id": "G-45463597",
      "version": 2,
      "status": "queued",
      "created_at": "2023-12-28T09:04:17.210Z",
      "completed_at": "2023-12-28T09:04:37.210Z",
      "custom_metadata": {
        "user": "John Doe"
      },
      "error_code": 500,
      "kind": "pre-recorded",
      "file": {
        "id": "<string>",
        "filename": "<string>",
        "source": "<string>",
        "audio_duration": 3600,
        "number_of_channels": 1
      },
      "request_params": {
        "context_prompt": "<string>",
        "custom_vocabulary": false,
        "custom_vocabulary_config": {
          "vocabulary": [
            "Westeros",
            {
              "value": "Stark"
            },
            {
              "value": "Night's Watch",
              "pronunciations": [
                "Nightz Watch"
              ],
              "intensity": 0.4,
              "language": "en"
            }
          ],
          "default_intensity": 0.5
        },
        "detect_language": true,
        "enable_code_switching": false,
        "code_switching_config": {
          "languages": []
        },
        "language": "en",
        "callback_url": "http://callback.example",
        "callback": false,
        "callback_config": {
          "url": "http://callback.example",
          "method": "POST"
        },
        "subtitles": false,
        "subtitles_config": {
          "formats": [
            "srt"
          ],
          "minimum_duration": 1,
          "maximum_duration": 15.5,
          "maximum_characters_per_row": 2,
          "maximum_rows_per_caption": 3,
          "style": "default"
        },
        "diarization": false,
        "diarization_config": {
          "number_of_speakers": 3,
          "min_speakers": 1,
          "max_speakers": 2,
          "enhanced": false
        },
        "translation": false,
        "translation_config": {
          "target_languages": [
            "en"
          ],
          "model": "base",
          "match_original_utterances": true,
          "lipsync": true,
          "context_adaptation": true,
          "context": "<string>",
          "informal": false
        },
        "summarization": false,
        "summarization_config": {
          "type": "general"
        },
        "moderation": false,
        "named_entity_recognition": false,
        "chapterization": false,
        "name_consistency": false,
        "custom_spelling": false,
        "custom_spelling_config": {
          "spelling_dictionary": {
            "Gettleman": [
              "gettleman"
            ],
            "SQL": [
              "Sequel"
            ]
          }
        },
        "structured_data_extraction": false,
        "structured_data_extraction_config": {
          "classes": [
            "Persons",
            "Organizations"
          ]
        },
        "sentiment_analysis": false,
        "audio_to_llm": false,
        "audio_to_llm_config": {
          "prompts": [
            "Extract the key points from the transcription"
          ]
        },
        "sentences": false,
        "display_mode": false,
        "punctuation_enhanced": false,
        "language_config": {
          "languages": [],
          "code_switching": false
        },
        "audio_url": "<string>"
      },
      "result": {
        "metadata": {
          "audio_duration": 3600,
          "number_of_distinct_channels": 1,
          "billing_time": 3600,
          "transcription_time": 20
        },
        "transcription": {
          "full_transcript": "<string>",
          "languages": [
            "en"
          ],
          "sentences": [
            {}
          ],
          "subtitles": [
            {}
          ],
          "utterances": [
            {}
          ]
        },
        "translation": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "results": [
            {}
          ]
        },
        "summarization": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "results": "<string>"
        },
        "moderation": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "results": "<string>"
        },
        "named_entity_recognition": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "entity": "<string>"
        },
        "name_consistency": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "results": "<string>"
        },
        "custom_spelling": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "results": "<string>"
        },
        "speaker_reidentification": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "results": "<string>"
        },
        "structured_data_extraction": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "results": "<string>"
        },
        "sentiment_analysis": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "results": "<string>"
        },
        "audio_to_llm": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "results": [
            {}
          ]
        },
        "sentences": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {},
          "results": [
            "<string>"
          ]
        },
        "display_mode": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "results": [
            "<string>"
          ]
        },
        "chapters": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "results": {}
        },
        "diarization_enhanced": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "results": [
            {}
          ]
        },
        "diarization": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "results": [
            {}
          ]
        }
      }
    }
  ]
}

Authorizations

​
x-gladia-key
string
header
required

Your personal Gladia API key

Query Parameters

​
offset
integer
default:0

The starting point for pagination. A value of 0 starts from the first item.

Required range: x >= 0
​
limit
integer
default:20

The maximum number of items to return. Useful for pagination and controlling data payload size.

Required range: x >= 1
​
date
string<date-time>

Filter items relevant to a specific date in ISO format (YYYY-MM-DD).

Example:

"2025-09-05"

​
before_date
string<date-time>

Include items that occurred before the specified date in ISO format.

Example:

"2025-09-05T12:00:03.754Z"

​
after_date
string<date-time>

Filter for items after the specified date. Use with before_date for a range. Date in ISO format.

Example:

"2025-09-05T12:00:03.754Z"

​
status
enum<string>[]

Filter the list based on item status. Accepts multiple values from the predefined list.

Example:
["done"]
​
custom_metadata
object
Example:
{ "user": "John Doe" }
​
kind
enum<string>[]

Filter the list based on the item type. Supports multiple values from the predefined list.

Example:
["pre-recorded"]

Response

A list of transcription jobs matching the parameters.

​
first
string<uri>
required

URL to fetch the first page

Example:

"https://api.gladia.io/v2/transcription?status=done&offset=0&limit=20"

​
current
string<uri>
required

URL to fetch the current page

Example:

"https://api.gladia.io/v2/transcription?status=done&offset=0&limit=20"

​
next
string<uri> | null
required

URL to fetch the next page

Example:

"https://api.gladia.io/v2/transcription?status=done&offset=20&limit=20"

​
items
object[]
required

List of transcriptions