Skip to main content
GET
https://api.destined.ai
/
v1
/
jobs
/
{job_id}
curl "https://api.destined.ai/v1/jobs/job_abc123xyz" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "job_id": "job_abc123xyz",
  "status": "completed",
  "progress": 100,
  "total_items": 3,
  "completed_items": 3,
  "created_at": "2024-01-15T10:30:00Z",
  "completed_at": "2024-01-15T10:31:00Z",
  "results": [
    {
      "index": 0,
      "speaker_id": "speaker-1",
      "audio_url": "https://destined-voice.s3.amazonaws.com/audio/gen_001.wav",
      "status": "success"
    },
    {
      "index": 1,
      "speaker_id": "speaker-2",
      "audio_url": "https://destined-voice.s3.amazonaws.com/audio/gen_002.wav",
      "status": "success"
    },
    {
      "index": 2,
      "speaker_id": "speaker-3",
      "audio_url": "https://destined-voice.s3.amazonaws.com/audio/gen_003.wav",
      "status": "success"
    }
  ]
}

Path Parameters

job_id
string
required
The unique job ID

Response

job_id
string
required
Unique job identifier
status
string
required
Job status: pending, processing, completed, failed, partial
progress
integer
required
Completion percentage (0-100)
total_items
integer
required
Total items in batch
completed_items
integer
required
Items completed so far
results
array
Array of results (only when status is completed or partial)
curl "https://api.destined.ai/v1/jobs/job_abc123xyz" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "job_id": "job_abc123xyz",
  "status": "completed",
  "progress": 100,
  "total_items": 3,
  "completed_items": 3,
  "created_at": "2024-01-15T10:30:00Z",
  "completed_at": "2024-01-15T10:31:00Z",
  "results": [
    {
      "index": 0,
      "speaker_id": "speaker-1",
      "audio_url": "https://destined-voice.s3.amazonaws.com/audio/gen_001.wav",
      "status": "success"
    },
    {
      "index": 1,
      "speaker_id": "speaker-2",
      "audio_url": "https://destined-voice.s3.amazonaws.com/audio/gen_002.wav",
      "status": "success"
    },
    {
      "index": 2,
      "speaker_id": "speaker-3",
      "audio_url": "https://destined-voice.s3.amazonaws.com/audio/gen_003.wav",
      "status": "success"
    }
  ]
}