Get all Audio Enhancements

This endpoint retrieves all of the Audio Enhancements in your user account.

HTTP Request

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

Query Parameters	Type	Description
page	number starting from 1	The page number to fetch.
page_size	number	Number of items per page.

1 2 curl --request GET "https://app.resemble.ai/api/v2/audio_enhancements?page=1&page_size=10" -H "Authorization: Bearer YOUR_API_TOKEN"

Request Headers

Header	Value	Description
Authorization	Bearer YOUR_API_TOKEN	API token can be obtained by logging into the Resemble web application and navigating to the API section.

HTTP Response

{
    "success": true,
    "page": 1,
    "num_pages": 20,
    "page_size": 10,
    "items": [
        {
            "uuid": "<audio_enhancement_uuid>",
            "status": "completed",
            "loudness_target_level": -5,
            "loudness_peak_limit": -1,
            "enhancement_level": 1.0,
            "original_audio_url": "https://example.com/original_audio.wav",
            "enhanced_audio_url": "https://example.com/enhanced_audio.wav"
        },
        {
            "uuid": "<audio_enhancement_uuid>",
            "status": "processing",
            "error_message": "Enhancement failed: Internal server error occurred.",
            "loudness_target_level": -5,
            "loudness_peak_limit": -1,
            "enhancement_level": 1.0,
            "original_audio_url": "https://example.com/original_audio.mp3",
            "error": "<error_message>"
        },
        {
            "uuid": "<audio_enhancement_uuid>",
            "status": "failed",
            "error_message": "<error_message>",
            "loudness_target_level": -5,
            "loudness_peak_limit": -1,
            "enhancement_level": 1.0,
            "original_audio_url": "https://example.com/original_audio.mp3"
        }
    ]
}

Response Body

Attribute	Type	Description
success	boolean	Whether the request was successful.
page	integer	The current page number.
num_pages	integer	The total number of pages available.
page_size	integer	Number of items per page.
items	array	List of audio enhancement items.
items[].uuid	string	The unique identifier for the enhancement job.
items[].status	string	Current status: "processing", "completed", or "failed".
items[].error_message	string	Description of the error if status is "failed".
items[].loudness_target_level	integer	Target loudness level in LUFS that was applied.
items[].loudness_peak_limit	integer	Maximum peak level in dBTP that was applied.
items[].enhancement_level	float	Level of enhancement that was applied.
items[].original_audio_url	string	URL to download the original audio.
items[].enhanced_audio_url	string	URL to download the enhanced audio. Only present when status is "completed".

Example

1 2 curl --request GET "https://app.resemble.ai/api/v2/audio_enhancements?page=1&page_size=10" -H "Authorization: Bearer YOUR_API_TOKEN"

Try It Out

API Key:

Page:

Page Size: