Skip to main content
GET
/
denoise
List Denoise History
curl --request GET \
  --url https://api.munsit.com/api/v1/denoise \
  --header 'x-api-key: <api-key>'
[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "user_id": "<string>",
    "original_audio_url": "<string>",
    "file_name": "<string>",
    "audio_duration": 123,
    "audio_size": 123,
    "audio_format": "<string>",
    "source_type": "audio",
    "status": "pending",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "transaction_id": "<string>",
    "audio_url": "<string>",
    "error": "<string>"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.munsit.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns the authenticated user’s denoising records ordered by most recently created first. Use this to retrieve the final audio URL of completed jobs, monitor pending jobs, or paginate through historical results.

Authentication

Requires API key authentication via x-api-key header.

Request

Query Parameters

ParameterTypeRequiredDescription
offsetinteger (≥ 0)NoNumber of records to skip from the start of the result set.
limitinteger (≥ 1)NoMaximum 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

FieldTypeDescription
idstring (UUID)Denoising record id (same value as denoiseId returned by POST /denoise).
user_idstringOwner of the record.
transaction_idstring | nullWallet transaction id associated with billing for this job, if any.
audio_urlstring | nullURL of the denoised audio. null until the job reaches success.
original_audio_urlstringURL of the originally uploaded file.
file_namestringOriginal file name as submitted by the client.
audio_durationnumberDuration of the source audio in seconds.
audio_sizenumberSize of the source file in bytes.
audio_formatstringLower-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.
errorstring | nullError message if status is failed.
created_atstring (ISO 8601)Creation timestamp.
updated_atstring (ISO 8601)Last update timestamp.

Example Response

[
  {
    "id": "5b1d2f7e-3f81-4c2a-9c5d-7a2e91b4c7a1",
    "user_id": "user_123",
    "transaction_id": "txn_abc",
    "audio_url": "https://cdn.munsit.com/denoising/user_123/5b1d2f7e_denoised.wav",
    "original_audio_url": "https://cdn.munsit.com/denoising/user_123/5b1d2f7e_original.wav",
    "file_name": "meeting.wav",
    "audio_duration": 312.4,
    "audio_size": 10485760,
    "audio_format": "wav",
    "source_type": "audio",
    "status": "success",
    "error": null,
    "created_at": "2026-05-12T10:14:02.000Z",
    "updated_at": "2026-05-12T10:14:55.000Z"
  }
]

Error Responses

400 Bad Request
{
  "errorCode": "400xx",
  "errorMessage": "offset must be a non-negative number"
}
{
  "errorCode": "400xx",
  "errorMessage": "limit must be a positive number"
}
401 Unauthorized
{
  "errorCode": "40101",
  "errorMessage": "Invalid or missing API key"
}

Example Usage

JavaScript

const response = await fetch('https://api.munsit.com/api/v1/denoise?offset=0&limit=20', {
  headers: {
    'x-api-key': 'YOUR_API_KEY',
  },
});

const records = await response.json();
records.forEach((r) => {
  console.log(r.id, r.status, r.audio_url);
});

Python

import requests

url = "https://api.munsit.com/api/v1/denoise"
headers = {"x-api-key": "YOUR_API_KEY"}
params = {"offset": 0, "limit": 20}

response = requests.get(url, headers=headers, params=params)
for record in response.json():
    print(record["id"], record["status"], record["audio_url"])

cURL

curl -X GET "https://api.munsit.com/api/v1/denoise?offset=0&limit=20" \
  -H "x-api-key: YOUR_API_KEY"

Authorizations

x-api-key
string
header
required

API key for authentication

Query Parameters

offset
integer

Number of records to skip from the start of the result set.

Required range: x >= 0
limit
integer

Maximum number of records to return. Omit to return all records.

Required range: x >= 1

Response

List of denoising records

id
string<uuid>
required

Denoising record id (same value as denoiseId returned by POST /denoise).

user_id
string
required

Owner of the record.

original_audio_url
string
required

URL of the originally uploaded file.

file_name
string
required

Original file name as submitted by the client.

audio_duration
number
required

Duration of the source audio in seconds.

audio_size
number
required

Size of the source file in bytes.

audio_format
string
required

Lower-cased file extension of the source file.

source_type
enum<string>
required

Whether the upload was an audio file or a video container.

Available options:
audio,
video
status
enum<string>
required

Current job status.

Available options:
pending,
success,
failed
created_at
string<date-time>
required
updated_at
string<date-time>
required
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.

error
string | null

Error message if status is failed.