Get Audio Enhancement

GET https://app.resemble.ai/api/v2/audio_enhancements/{uuid}

Poll this endpoint to check the status of an enhancement job and retrieve the download URL when complete.

Path Parameters

ParameterTypeRequiredNotes
uuidstringThe UUID returned from the Create Enhancement endpoint.
$curl 'https://app.resemble.ai/api/v2/audio_enhancements/ENHANCEMENT_UUID' \
> -H 'Authorization: Bearer YOUR_API_TOKEN'

Success Response

Status: 200 OK

1{
2 "success": true,
3 "uuid": "ENHANCEMENT_UUID",
4 "status": "completed",
5 "enhanced_audio_url": "https://app.resemble.ai/rails/active_storage/blobs/...",
6 "error_message": null
7}

Status Values

StatusMeaningAction
pendingJob is queuedContinue polling
processingEnhancement in progressContinue polling
completedDone — enhanced_audio_url is availableDownload the enhanced audio
failedProcessing failedRead error_message for details

Response Fields

FieldTypeDescription
uuidstringEnhancement identifier.
statusstringOne of: pending, processing, completed, failed.
enhanced_audio_urlstring or nullDownload URL. Only present when status is completed.
error_messagestring or nullHuman-readable error. Only present when status is failed.

Error Responses

StatusConditionExample
404UUID not found or belongs to another team{"success": false, "message": "Audio enhancement not found or not accessible"}

The enhanced_audio_url is a temporary signed URL. Download it promptly after receiving a completed status. The output format is WAV regardless of the input format.