> ## Documentation Index
> Fetch the complete documentation index at: https://docs.destined.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Job

> Get status and results of a batch job

## Path Parameters

<ParamField path="job_id" type="string" required>
  The unique job ID
</ParamField>

## Response

<ResponseField name="job_id" type="string" required>
  Unique job identifier
</ResponseField>

<ResponseField name="status" type="string" required>
  Job status: `pending`, `processing`, `completed`, `failed`, `partial`
</ResponseField>

<ResponseField name="progress" type="integer" required>
  Completion percentage (0-100)
</ResponseField>

<ResponseField name="total_items" type="integer" required>
  Total items in batch
</ResponseField>

<ResponseField name="completed_items" type="integer" required>
  Items completed so far
</ResponseField>

<ResponseField name="results" type="array">
  Array of results (only when status is `completed` or `partial`)
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.destined.ai/v1/jobs/job_abc123xyz" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```typescript TypeScript theme={null}
  const job = await client.jobs.getJobV1JobsJobIdGet({
    jobId: "job_abc123xyz",
  });

  if (job.status === "completed") {
    for (const result of job.results) {
      console.log(result.audioUrl);
    }
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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://voice.s3.amazonaws.com/audio/gen_001.wav",
        "status": "success"
      },
      {
        "index": 1,
        "speaker_id": "speaker-2",
        "audio_url": "https://voice.s3.amazonaws.com/audio/gen_002.wav",
        "status": "success"
      },
      {
        "index": 2,
        "speaker_id": "speaker-3",
        "audio_url": "https://voice.s3.amazonaws.com/audio/gen_003.wav",
        "status": "success"
      }
    ]
  }
  ```
</ResponseExample>
