Skip to main content
GET
Get a diarization

Authorizations

Authorization
string
header
required

Your API key: Authorization: Bearer aircaps_sk_...

Path Parameters

id
string
required

Diarization ID.

Example:

"dia_01k72p0x9h6t3b8r1n4m7q2w5e"

Response

The diarization.

id
string
required

Diarization ID.

Example:

"dia_01k72p0x9h6t3b8r1n4m7q2w5e"

object
enum<string>
required
Available options:
diarization
Example:

"diarization"

status
enum<string>
required

queued: waiting for a processing slot. processing: being diarized. completed: result fields present. error: see error.

Available options:
queued,
processing,
completed,
error
created_at
string<date-time>
required

When the diarization was created (UTC).

started_at
string<date-time> | null
required

When processing started.

completed_at
string<date-time> | null
required

When the job finished (completed or error).

audio_url
string | null
required

The submitted audio_url, if any.

file_id
string | null
required

The submitted file_id, if any.

model
enum<string>
required
Available options:
aircaps-diarization-v1
audio_duration
number | null
required

Audio duration in seconds, once known.

Example:

3600.512

metadata
object | null
required

Your metadata, echoed back.

webhook_url
string | null
required

Webhook target, if any.

webhook_status
enum<string> | null
required

Webhook delivery state, if webhook_url was set.

Available options:
pending,
delivered,
failed,
null
webhook_status_code
integer | null
required

HTTP status of the last webhook delivery.

error
object | null
required

Set when status is error.

num_speakers
integer

Completed only. Number of speakers found.

Example:

3

speakers
object[]

Completed only. Every speaker, with their speaking time.

segments
object[]

Completed only. Who spoke when, in time order. Overlapping speech appears as overlapping segments of different speakers.

speech_duration
number

Completed only. Seconds in which anyone speaks.

Example:

1498.27

overlap_duration
number

Completed only. Seconds in which two or more people speak at once.

Example:

61.44