Check the progress of a process

You can check the status of your job by polling the API using the unique process ID (pid) with a GET request. The response will be in application/json format and will include, among other fields, the current status of the job:

Status possible values	Status description
0	Pending - the audio has been submitted for processing
1	Processing started - The audio is being processed
2	Processing complete - The audio has been processed and results are available
-1, -3	Server error while processing the audio
-2	Insufficient credits - Increase your balance in the Billing section of the console

Example of a request/response:

curl --location 'https://api.behavioralsignals.com/v5/clients/<your-client-id>/processes/<pid>' \
--header 'X-Auth-Token: your-api-token'

{
  "pid": 1,
  "cid": <your-client-id>,
  "name": "my-awesome-audio",
  "status": 2,
  "statusmsg": "Processing Complete",
  "duration": 5.03,
  "datetime": "2026-09-03T12:08:32.507864"
}

Or using the SDK:

from behavioralsignals import Client

client = Client()

process = client.behavioral.get_process(pid=12345)  # your process ID
print(process.status, process.statusmsg)

process is a ProcessItem (defined here) with the same schema as the JSON above.

What’s Next