List Denoise History
Return the authenticated user’s denoising records ordered by most recently created first. Use this to retrieve the final URL of completed jobs or paginate through history.
Authentication
Requires API key authentication viax-api-key header.
Request
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
offset | integer (≥ 0) | No | Number of records to skip from the start of the result set. |
limit | integer (≥ 1) | No | Maximum number of records to return. Omit to return all records. |
Response
Status Code:200 OK
Content-Type: application/json
Returns an array of denoising records.
Record Schema
| Field | Type | Description |
|---|---|---|
id | string (UUID) | Denoising record id (same value as denoiseId returned by POST /denoise). |
user_id | string | Owner of the record. |
transaction_id | string | null | Wallet transaction id associated with billing for this job, if any. |
audio_url | string | null | URL of the denoised audio. null until the job reaches success. |
original_audio_url | string | URL of the originally uploaded file. |
file_name | string | Original file name as submitted by the client. |
audio_duration | number | Duration of the source audio in seconds. |
audio_size | number | Size of the source file in bytes. |
audio_format | string | Lower-cased file extension of the source file (e.g. wav, mp4). |
source_type | "audio" | "video" | Whether the upload was an audio file or a video container. |
status | "pending" | "success" | "failed" | Current job status. |
error | string | null | Error message if status is failed. |
created_at | string (ISO 8601) | Creation timestamp. |
updated_at | string (ISO 8601) | Last update timestamp. |
Example Response
Error Responses
400 Bad RequestExample Usage
JavaScript
Python
cURL
Authorizations
API key for authentication
Query Parameters
Number of records to skip from the start of the result set.
x >= 0Maximum number of records to return. Omit to return all records.
x >= 1Response
List of denoising records
Denoising record id (same value as denoiseId returned by POST /denoise).
Owner of the record.
URL of the originally uploaded file.
Original file name as submitted by the client.
Duration of the source audio in seconds.
Size of the source file in bytes.
Lower-cased file extension of the source file.
Whether the upload was an audio file or a video container.
audio, video Current job status.
pending, success, failed Wallet transaction id associated with billing for this job, if any.
URL of the denoised audio. Null until the job reaches success.
Error message if status is failed.
