---
title: "Get job by ID"
method: GET
path: "/v1/jobs/{jobId}"
tags: ["Api", "Jobs"]
---

# Get job by ID

`GET /v1/jobs/{jobId}`

## Path parameters

- `jobId` string, required

## Response `200`

- union
  - DiarizationJob
    - `jobId` string — Job ID to track the progress or get the results
    - `status` 'pending' | 'created' | 'succeeded' | 'canceled' | 'failed' | 'running' — Status of the job
    - `createdAt` string, date-time — Date and time the job was created
    - `updatedAt` string, date-time — Date and time the job was last updated
    - `output` DiarizationJobOutput
      - `diarization` DiarizationSegment[], required — List of diarization segments
        - `speaker` string, required — Speaker label
        - `start` number, required — Start time of the segment in seconds
        - `end` number, required — End time of the segment in seconds
        - `confidence` object — Confidence scores that this speech turn matches each diarization speaker. Only available if `turnLevelConfidence` is set to true when job is created.
      - `confidence` Confidence
        - `score` number[], required — List of confidence scores for each sample. Values are between 0 and 100
        - `resolution` number, required — Resolution of the confidence scores. Value is number of seconds per sample
      - `exclusiveDiarization` DiarizationSegment[] — Exclusive diarization segments where only one speaker is active at a time. Only returned if `exclusive` is set to true when job is created.
        - `speaker` string, required — Speaker label
        - `start` number, required — Start time of the segment in seconds
        - `end` number, required — End time of the segment in seconds
        - `confidence` object — Confidence scores that this speech turn matches each diarization speaker. Only available if `turnLevelConfidence` is set to true when job is created.
      - `wordLevelTranscription` TranscriptionSegment[] — Word-level transcription segments with text. Only returned if `transcription` is set to true when job is created.
        - `start` number, required — Start time of the segment in seconds
        - `end` number, required — End time of the segment in seconds
        - `text` string, required — The transcribed speech content for this segment
        - `speaker` string, required — Speaker label
      - `turnLevelTranscription` TranscriptionSegment[] — Turn-level (speaker turn) transcription segments with text. Only returned if `transcription` is set to true when job is created.
        - `start` number, required — Start time of the segment in seconds
        - `end` number, required — End time of the segment in seconds
        - `text` string, required — The transcribed speech content for this segment
        - `speaker` string, required — Speaker label
      - `error` string — Error message if any
      - `warning` string — Warning message if any
  - VoiceprintJob
    - `jobId` string — Job ID to track the progress or get the results
    - `status` 'pending' | 'created' | 'succeeded' | 'canceled' | 'failed' | 'running' — Status of the job
    - `createdAt` string, date-time — Date and time the job was created
    - `updatedAt` string, date-time — Date and time the job was last updated
    - `output` VoiceprintJobResults
      - `voiceprint` string, required — Voiceprint of the audio. To be used for identification
      - `warning` string — Warning message if any
      - `error` string — Error message if any
  - IdentifyJob
    - `jobId` string — Job ID to track the progress or get the results
    - `status` 'pending' | 'created' | 'succeeded' | 'canceled' | 'failed' | 'running' — Status of the job
    - `createdAt` string, date-time — Date and time the job was created
    - `updatedAt` string, date-time — Date and time the job was last updated
    - `output` IdentificationJobOutput
      - `diarization` DiarizationSegment[] — List of diarization segments
        - `speaker` string, required — Speaker label
        - `start` number, required — Start time of the segment in seconds
        - `end` number, required — End time of the segment in seconds
        - `confidence` object — Confidence scores that this speech turn matches each diarization speaker. Only available if `turnLevelConfidence` is set to true when job is created.
      - `confidence` Confidence
        - `score` number[], required — List of confidence scores for each sample. Values are between 0 and 100
        - `resolution` number, required — Resolution of the confidence scores. Value is number of seconds per sample
      - `exclusiveDiarization` DiarizationSegment[] — Exclusive diarization segments where only one speaker is active at a time. Only returned if `exclusive` is set to true when job is created.
        - `speaker` string, required — Speaker label
        - `start` number, required — Start time of the segment in seconds
        - `end` number, required — End time of the segment in seconds
        - `confidence` object — Confidence scores that this speech turn matches each diarization speaker. Only available if `turnLevelConfidence` is set to true when job is created.
      - `error` string — Error message if any
      - `warning` string — Warning message if any
      - `identification` IdentificationSegment[] — List of identification segments
        - `speaker` string — Speaker label
        - `start` number — Start time of the segment in seconds
        - `end` number — End time of the segment in seconds
        - `confidence` object — Confidence scores that this speech turn matches each diarization speaker. Only available if `turnLevelConfidence` is set to true when job is created.
        - `diarizationSpeaker` string, required — Speaker label
        - `match` string, nullable, required — Label of the voiceprint that was identified following the matching settings
      - `voiceprints` IdentificationVoiceprint[]
        - `speaker` string, required — Diarization speaker
        - `match` string, required — Label of the voiceprint that was identified following the matching settings
        - `confidence` object, required — Confidence for each speaker label, as a dictionary of speaker label to confidence score

## Other responses

- `400` — Invalid request
- `402` — Subscription is required
- `429` — Too many requests

---

[API](https://skmtc.net/pyannote/apis/pyannoteai-api.md) · [All operations](https://skmtc.net/pyannote/apis/pyannoteai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pyannote/pyannoteai-api/revisions/9d61c3f2d6bb/schema)