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

Parameter	Type	Required	Notes
`uuid`	string	✅	The 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

Status	Meaning	Action
`pending`	Job is queued	Continue polling
`processing`	Enhancement in progress	Continue polling
`completed`	Done — `enhanced_audio_url` is available	Download the enhanced audio
`failed`	Processing failed	Read `error_message` for details

Response Fields

Field	Type	Description
`uuid`	string	Enhancement identifier.
`status`	string	One of: `pending`, `processing`, `completed`, `failed`.
`enhanced_audio_url`	string or null	Download URL. Only present when status is `completed`.
`error_message`	string or null	Human-readable error. Only present when status is `failed`.

Error Responses

Status	Condition	Example
`404`	UUID 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.

$	curl 'https://app.resemble.ai/api/v2/audio_enhancements/ENHANCEMENT_UUID' \
>	-H 'Authorization: Bearer YOUR_API_TOKEN'

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	}