GET
/
v2
/
pre-recorded
/
{id}
Get the pre recorded job's metadata
curl --request GET \
  --url https://api.gladia.io/v2/pre-recorded/{id} \
  --header 'x-gladia-key: <api-key>'
{
  "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": [
        {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": "<any>",
            "exception": "<any>",
            "message": "<any>"
          },
          "results": [
            "<any>"
          ]
        }
      ],
      "subtitles": [
        {
          "format": "srt",
          "subtitles": "<string>"
        }
      ],
      "utterances": [
        {
          "start": 123,
          "end": 123,
          "confidence": 123,
          "channel": 1,
          "speaker": 1,
          "words": [
            "<any>"
          ],
          "text": "<string>",
          "language": "en"
        }
      ]
    },
    "translation": {
      "success": true,
      "is_empty": true,
      "exec_time": 123,
      "error": {
        "status_code": 500,
        "exception": "<string>",
        "message": "<string>"
      },
      "results": [
        {
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "full_transcript": "<string>",
          "languages": [
            "en"
          ],
          "sentences": [
            {
              "success": true,
              "is_empty": true,
              "exec_time": 123,
              "error": {
                "status_code": "<any>",
                "exception": "<any>",
                "message": "<any>"
              },
              "results": [
                "<any>"
              ]
            }
          ],
          "subtitles": [
            {
              "format": "srt",
              "subtitles": "<string>"
            }
          ],
          "utterances": [
            {
              "start": 123,
              "end": 123,
              "confidence": 123,
              "channel": 1,
              "speaker": 1,
              "words": [
                "<any>"
              ],
              "text": "<string>",
              "language": "en"
            }
          ]
        }
      ]
    },
    "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>"
    },
    "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": [
        {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "results": {
            "prompt": "<string>",
            "response": "<string>"
          }
        }
      ]
    },
    "sentences": {
      "success": true,
      "is_empty": true,
      "exec_time": 123,
      "error": {
        "status_code": "<any>",
        "exception": "<any>",
        "message": "<any>"
      },
      "results": [
        "<any>"
      ]
    },
    "display_mode": {
      "success": true,
      "is_empty": true,
      "exec_time": 123,
      "error": {
        "status_code": 500,
        "exception": "<string>",
        "message": "<string>"
      },
      "results": [
        "<string>"
      ]
    },
    "chapterization": {
      "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": [
        {
          "start": 123,
          "end": 123,
          "confidence": 123,
          "channel": 1,
          "speaker": 1,
          "words": [
            "<any>"
          ],
          "text": "<string>",
          "language": "en"
        }
      ]
    },
    "diarization": {
      "success": true,
      "is_empty": true,
      "exec_time": 123,
      "error": {
        "status_code": 500,
        "exception": "<string>",
        "message": "<string>"
      },
      "results": [
        {
          "start": 123,
          "end": 123,
          "confidence": 123,
          "channel": 1,
          "speaker": 1,
          "words": [
            "<any>"
          ],
          "text": "<string>",
          "language": "en"
        }
      ]
    }
  }
}

Authorizations

​
x-gladia-key
string
header
required

Your personal Gladia API key

Path Parameters

​
id
string
required

Id of the pre recorded job

Example:

"45463597-20b7-4af7-b3b3-f5fb778203ab"

Response

The pre recorded job's metadata

​
id
string<uuid>
required

Id of the job

Example:

"45463597-20b7-4af7-b3b3-f5fb778203ab"

​
request_id
string
required

Debug id

Example:

"G-45463597"

​
version
integer
required

API version

Example:

2

​
status
enum<string>
required

"queued": the job has been queued. "processing": the job is being processed. "done": the job has been processed and the result is available. "error": an error occurred during the job's processing.

Available options:
queued,
processing,
done,
error
​
created_at
string<date-time>
required

Creation date

Example:

"2023-12-28T09:04:17.210Z"

​
kind
enum<string>
default:pre-recorded
required
Available options:
pre-recorded
Example:

"pre-recorded"

​
completed_at
string<date-time> | null

Completion date when status is "done" or "error"

Example:

"2023-12-28T09:04:37.210Z"

​
custom_metadata
object

Custom metadata given in the initial request

Example:
{ "user": "John Doe" }
​
error_code
integer | null

HTTP status code of the error if status is "error"

Required range: 400 <= x <= 599
Example:

500

​
file
object

The file data you uploaded. Can be null if status is "error"

​
request_params
object

Parameters used for this pre-recorded transcription. Can be null if status is "error"

​
result
object

Pre-recorded transcription's result when status is "done"