As an alternative to webhooks, you can poll the get job endpoint to retrieve job results. To poll for job results, use the status field in the job response to check if the job is completed. Once the job is completed, you can retrieve the job results by accessing the output field.
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.
A job is completed when the status field is either succeeded, failed, or canceled.
Be cautious of rate limits when polling. Excessive requests to check job status can lead to rate limiting, potentially disrupting your workflow. Check the rate limits documentation for more information.
In production environments, we strongly recommend using webhooks instead of polling. This guarantees that you get job results as soon as they are available. Additionally, you won’t have to worry about rate limits.

​
Example

Here’s an example of how to poll for job results in Python:
Python
import requests
import time

API_KEY = "your_api_key_here"

# Select audio file to process
payload = {
    "url": "https://example.com/audio.wav"
}

# Define headers
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Create a diarization job
response = requests.request("POST", "https://api.pyannote.ai/v1/diarize", json=payload, headers=headers)

# Check if the request was successful
if response.status_code != 200:
    raise Exception(f"Failed to create job: {response.status_code} - {response.text}")

# Parse response
data = response.json()

# Get the job ID
job_id = data["jobId"]

# Poll for job status
job_status = data["status"]
while job_status not in ["succeeded", "failed", "canceled"]:
    response = requests.request("GET", f"https://api.pyannote.ai/v1/jobs/{job_id}", headers=headers)
    if response.status_code == 200:
        job_status = response.json()["status"]
    else:
        raise Exception(f"Failed to get job status: {response.status_code} - {response.text}")
    time.sleep(10) # wait 10 seconds before polling again

# Get the job results
output = response.json()["output"]