List Audio Enhancements

GET https://app.resemble.ai/api/v2/audio_enhancements

Returns a paginated list of all audio enhancements for your team, ordered by most recent first.

Query Parameters

ParameterTypeRequiredNotes
pageintegerPage number (starting from 1).
page_sizeintegerItems per page (10 to 1000). Default: 10.
$curl 'https://app.resemble.ai/api/v2/audio_enhancements?page=1&page_size=20' \
> -H 'Authorization: Bearer YOUR_API_TOKEN'

Success Response

Status: 200 OK

1{
2 "success": true,
3 "page": 1,
4 "num_pages": 5,
5 "page_size": 10,
6 "total_count": 47,
7 "items": [
8 {
9 "uuid": "ENHANCEMENT_UUID",
10 "status": "completed",
11 "enhancement_engine": "v2",
12 "remove_noise": true,
13 "normalize": true,
14 "studio_sound": true,
15 "original_audio_url": "https://...",
16 "enhanced_audio_url": "https://..."
17 }
18 ]
19}

Item Fields

FieldTypeDescription
uuidstringEnhancement identifier.
statusstringpending, processing, completed, or failed.
enhancement_enginestring"v1" or "v2".
error_messagestringOnly present on failed enhancements.
remove_noisebooleanEngine v2 only.
normalizebooleanEngine v2 only.
studio_soundbooleanEngine v2 only.
loudness_target_levelintegerEngine v1 only.
loudness_peak_limitintegerEngine v1 only.
enhancement_levelfloatEngine v1 only.
original_audio_urlstringURL to the uploaded original file.
enhanced_audio_urlstringURL to the enhanced file. Only present when completed.

Null fields are omitted from the response.

Error Responses

StatusConditionExample
400Invalid page (< 1){"success": false, "message": "page must be >= 1"}
400Invalid page_size{"success": false, "message": "page_size must be between 10 and 1000"}