Skip to main content
GET
/
v1
/
jobs
/
{jobId}
Get job by ID
curl --request GET \
  --url https://api.pyannote.ai/v1/jobs/{jobId} \
  --header 'Authorization: Bearer <token>'
{
  "jobId": "fb16c565-f3f0-4402-a08c-9d44df0ccc7b",
  "status": "pending",
  "createdAt": "2024-02-20T12:00:00Z",
  "updatedAt": "2024-02-20T12:00:00Z",
  "output": {
    "diarization": [
      {
        "speaker": "SPEAKER_00",
        "start": 15,
        "end": 30.5,
        "confidence": {
          "SPEAKER_00": 16,
          "SPEAKER_01": 93
        }
      }
    ],
    "confidence": {
      "score": [
        95,
        89,
        78,
        67,
        56,
        45,
        34,
        23,
        12,
        1
      ],
      "resolution": 0.02
    },
    "error": "<string>",
    "warning": "<string>"
  }
}
This endpoint allows you to retrieve the details of a job that you have created, including the results if the job is completed.
The output field contains the job results and is only available when the job status is succeeded. Job results are automatically deleted after 24 hours of job completion.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
jobId
string
required

Job ID to track the progress

Response

  • Diarization
  • Voiceprint
  • Identification
​
jobId
string

Job ID to track the progress or get the results

Example:

"fb16c565-f3f0-4402-a08c-9d44df0ccc7b"

​
status
enum<string>

Status of the job

Available options:
pending,
created,
succeeded,
canceled,
failed,
running
​
createdAt
string<date-time>

Date and time the job was created

Example:

"2024-02-20T12:00:00Z"

​
updatedAt
string<date-time>

Date and time the job was last updated

Example:

"2024-02-20T12:00:00Z"

​
output
object

Output segments of a diarization, available for 24 hours after job completion