API v1.0 • Beta

Transgate API

A powerful RESTful API for transcription jobs. Submit audio files and retrieve high-quality transcription results with speaker identification.

Authentication

All API requests require an API key to be included in the request header:

Authorization: Bearer YOUR_API_KEY
1

Submit Transcription Job (URL)

Submit an audio file for transcription by providing its URL.

Endpoint

POST /api/v1/transcriptions/url

Request Body

1{
2  "audio_url": "https://example.com/audio.mp3",
3  "language": "Azerbaijani",  // Optional
4  "callback_url": "https://your-callback-url.com/webhook"  // Optional
5}

Example

1curl -X POST https://transgate.ai/api/v1/transcriptions/url \
2  -H "Authorization: Bearer YOUR_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5  "audio_url": "https://example.com/audio.mp3",
6  "language": "Azerbaijani",
7  "callback_url": "https://your-callback-url.com/webhook"
8}'

Response (202 Accepted)

1{
2  "job_id": "123"
3}

Possible Error Responses

400

Bad Request: Invalid request body

401

Unauthorized: Invalid or missing API key

402

Payment Required: Insufficient balance

500

Internal Server Error: Server-side error

2

Get Transcription Status and Results

Retrieve the status and results of a transcription job.

Endpoint

GET /api/v1/transcriptions/[job_id]

Example

1curl -X GET https://transgate.ai/api/v1/transcriptions/123 \
2  -H "Authorization: Bearer YOUR_API_KEY"

Response (200 OK)

1{
2  "job": {
3    "id": 123,
4    "status": "completed",
5    "duration": "00:05:30",
6    "language": "en",
7    "audio_url": "https://example.com/audio.mp3"
8  },
9  "result": [
10    {
11      "start_time": "00:00:00",
12      "end_time": "00:00:05",
13      "text": "Hello, this is the first segment of the transcription.",
14      "corrected_text": "Hello, this is the first segment of the transcription.",
15      "speaker": "SPEAKER_00"
16    }
17  ],
18  "errors": [
19    {
20      "message": "Error message",
21      "stage": "download|validation|duration|processing|transcription|diarization|alignment|speaker_assignment|grammar_fixing|callback|logs",
22      "category": "fatal|partial|transient",
23    }
24  ]
25}

Possible Error Responses

400

Bad Request: Invalid job ID

401

Unauthorized: Invalid or missing API key

404

Not Found: Job not found

500

Internal Server Error: Server-side error

Job Statuses

draft

Transcription job has been created but not yet submitted

not_started

Transcription job has been submited but not yet started

pending

Transcription will start soon

running

Transcription is in progress

speaker_labeling

Speaker labeling is in progress

completed

Transcription is finished and available

failed

Transcription failed due to an error partially or fully

canceled

Transcription was canceled by the user

deleted

Transcription was deleted by the user

Important Notes

1

The language parameter is optional. If not provided, the system will attempt to auto-detect the language.

2

The callback_url is optional. If provided, you will receive a webhook notification when the transcription is complete.

3

Make sure you have sufficient balance in your account before submitting transcription jobs.

4

Audio URLs must be publicly accessible. You can generate a pre-signed url if hosted on S3 or GCS for example.

5

The API supports various audio formats (MP3, WAV, etc.). Check the system documentation for supported formats.

SECURE & COMPLETELY CUSTOMIZED DATA TRANSCRIPTION FOR A VARIETY OF INDUSTRIES

Copyright Ⓒ 2025 Transgate.ai All Rights Reserved.

info@transgate.ai

Payment Methods
social-media-1social-media-2social-media-3social-media-4social-media-5