Audio Status

Base URL for your account: https://cpaas.studio/api/v1

GET POST /api/v1/voice/audio/status

Look up one audio asset, or list all of them. Requires a key scoped to voice.obd or all.

Parameters

Param	Type	Required	Notes
`audio_uid`	string	no	Single-asset lookup by the opaque uid returned from Audio Upload. Takes precedence over reference if both are supplied.
`reference`	string	no	Single-asset lookup by the value you supplied on upload. If more than one asset shares a reference, the most recently uploaded one is returned.
`status`	string	no	Filters a list: pending, approved, rejected, or disabled (enabled=false). Ignored if audio_uid/reference is also supplied.
`page`	integer	no	Default 1.
`per_page`	integer	no	Default 25, max 100.

Request example

curl "https://cpaas.studio/api/v1/voice/audio/status?audio_uid=AUD7K2M9QX4WQ" \
  -H "X-API-KEY: cpk_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

<?php
$query = http_build_query(['audio_uid' => 'AUD7K2M9QX4WQ']);
$ch = curl_init("https://cpaas.studio/api/v1/voice/audio/status?{$query}");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-KEY: cpk_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

Success response (`data`)

{
    "audio_uid": "AUD7K2M9QX4WQ",
    "name": "Welcome Greeting",
    "reference": "customer-ref-001",
    "status": "approved",
    "enabled": true,
    "rejection_reason": null,
    "duration_seconds": 8,
    "size_bytes": 128000,
    "format": "wav",
    "approved_at": "2026-08-14T12:05:00+00:00",
    "created_at": "2026-08-14T12:00:00+00:00"
}

Errors

Code	Status	When
`AUDIO_NOT_FOUND`	404	audio_uid/reference doesn't match any of your assets.
`REQ_VALIDATION_FAILED`	422	Invalid status value, or an out-of-range page/per_page.

Notes

No params → your account's full list, paginated, newest first.
status in the response is the approval state; enabled is a separate, customer-controlled flag toggled via Audio Enable/Disable.
A list response uses the same pagination block shape as every other list endpoint in this API.

Need more context? See Getting started for authentication, the response envelope, and the full error-code reference.

Get In Touch