batch audio transcription api webhook

If you want a batch audio transcription API with webhook callbacks, the usual pattern is:

1. Upload audio files or provide URLs
2. Create a transcription job
3. API processes files asynchronously
4. Webhook notifies you when each file or the whole batch is done

Typical API design

1) Create a batch job

POST /transcriptions/batch

Request

{
  "files": [
    { "url": "https://example.com/audio1.mp3" },
    { "url": "https://example.com/audio2.wav" }
  ],
  "language": "en",
  "webhook_url": "https://yourapp.com/webhooks/transcription"
}

Response

{
  "batch_id": "batch_123",
  "status": "queued"
}

2) Webhook callback

When each transcript is ready, the API sends a POST to your webhook endpoint:

POST /webhooks/transcription

Payload

{
  "batch_id": "batch_123",
  "file_id": "file_1",
  "status": "completed",
  "transcript": "Hello world...",
  "confidence": 0.98
}

Or if you prefer a batch-level completion event:

{
  "batch_id": "batch_123",
  "status": "completed",
  "results": [
    {
      "file_id": "file_1",
      "transcript": "..."
    },
    {
      "file_id": "file_2",
      "transcript": "..."
    }
  ]
}

Recommended webhook fields

Include:

• event_id
• batch_id
• file_id
• status
• transcript or result_url
• error if failed
• created_at
• signature for verification

Example:

{
  "event_id": "evt_456",
  "batch_id": "batch_123",
  "file_id": "file_1",
  "event": "transcription.completed",
  "status": "completed",
  "result_url": "https://api.example.com/results/file_1",
  "created_at": "2026-10-11T12:00:00Z"
}

Important webhook best practices

• Verify signatures to confirm requests are from the API
• Retry on failures with exponential backoff
• Make webhooks idempotent using event_id
• Respond with 2xx quickly
• Store results and process asynchronously on your side

If you’re building this API

A simple architecture:

• API server accepts batch request
• Queue workers handle transcription
• Result store saves transcripts
• Webhook sender posts completion events
• Retry system handles webhook failures

If you want a specific implementation

I can help you with any of these:

• Node.js webhook + batch transcription backend
• Python/FastAPI example
• OpenAPI spec
• AWS/S3 + SQS architecture
• Using OpenAI/Whisper for transcription
• Webhook signature verification code

If you want, I can draft a full batch transcription API spec with webhook callbacks.