Documentation
Developers / Sound Cleaning
List sound cleaning jobs
https://api.echonova.ai/v1/sound-cleaning/jobsLists the API jobs in this key's workspace, paged with offset and limit. Needs Sound Cleaning access on the key.
Headers
Bearer, a space, then your API key, which starts with ek_. Create keys in the portal under Developers, API Keys.
Query parameters
How many jobs to skip.
How many jobs to return.
Response
200 application/json Every response uses this envelope.
The result.
The items on this page.
The job id.
pending, processing, completed or failed.
The name of the uploaded file.
Time-limited link to the cleaned WAV.
Length of the audio in seconds.
Credits charged, a whole number.
The tuning values the job ran with.
High-pass cutoff in Hz.
High-pass smoothness.
Target loudness in LUFS.
Peak ceiling in dBFS.
Compressor threshold in dBFS.
Compressor ratio.
Compressor attack in ms.
Compressor release in ms.
Measurements of the cleaned file.
Sample rate of the cleaned file in Hz.
Measured loudness of the cleaned file in LUFS.
Measured peak of the cleaned file in dBFS.
The reason the job failed. Absent unless status is failed.
When the job was created, ISO 8601 in UTC.
The total number of items.
true for a successful call.
Repeats the HTTP status.
null on success.
Errors
Same envelope, with success false and data null. All errors
When. offset on a jobs list is negative.
Fix. Send 0 or more.
When. offset is not a whole number.
Fix. Send an integer.
When. limit on a jobs list is below 1.
Fix. Send 1 to 100.
When. limit on a jobs list is above 100.
Fix. Send 1 to 100.
When. limit is not a number at all.
Fix. Send an integer from 1 to 100.
When. The body or query carries a field the endpoint does not define.
Fix. Remove the field.
When. The Authorization header is missing or is not Bearer ek_..., no key matches the token, or the key is deleted, disabled or its account is closed.
Fix. Send Authorization: Bearer ek_... with an enabled key from this environment.
When. The workspace that owns the key has no subscription.
Fix. Check the workspace's plan in the portal.
When. The subscription is in a state other than active or trial.
Fix. Renew the subscription.
When. The key is restricted and Sound Cleaning is not among its services.
Fix. Edit the key and turn Sound Cleaning on, or use another key.
When. The key made more than 100 requests to one endpoint in 60 seconds, or one IP address made more than 100 requests to one endpoint in 60 seconds (the IP limit is counted before the key is checked, so it can answer with no key at all); a Retry-After header carries the seconds to wait.
Fix. Wait Retry-After seconds, then retry.
When. An error the API did not classify.
Fix. Check the request, then retry after a short wait; contact support if it persists.
When. A transient outage inside the API.
Fix. Retry after a short wait.
When. A transient timeout inside the API.
Fix. Retry after a short wait.
curl "https://api.echonova.ai/v1/sound-cleaning/jobs" \
-H "Authorization: Bearer YOUR_API_KEY"{
"data": {
"items": [
{
"id": "66e3f2a1c9d4b8a1f0e12345",
"status": "completed",
"fileName": "noisy.wav",
"outputUrl": "https://storage.example.com/cleaned/66e3f2a1c9d4b8a1f0e12345.wav?signature=abc",
"durationSeconds": 12,
"creditsConsumed": 207,
"options": {
"cutoffFreq": 90,
"qFactor": 0.707,
"targetLufs": -16,
"truePeakDbfs": -1,
"compThreshDb": -3.8,
"compRatio": 4,
"compAttackMs": 5,
"compReleaseMs": 50
},
"metrics": {
"sampleRate": 48000,
"integratedLufs": -16.1,
"truePeakDbfs": -1
},
"error": "The audio could not be cleaned.",
"createdAt": "2026-10-11T10:21:04.512Z"
}
],
"total": 1
},
"success": true,
"statusCode": 200,
"errorMessage": null
}