Skip to main content
GET
Get Recovery Audio Details
Query a recovery task created by Recovery Audio and read the recovered audio links.

Status Descriptions

  • 201 — the recovery task is still running, keep polling
  • 200 — the recovery finished and at least one track was recovered successfully
  • 500 — every track failed to recover

Per-track status

  • successaudio_url carries the recovered playable link
  • failedaudio_url is empty and error explains the reason
Common error values:

Developer Notes

  • Poll this endpoint instead of waiting for the callback when you cannot expose a public callback URL. A 2 second interval is recommended.
  • data is null while code is 201.
  • A recovered audio_url may be an .m4a file — do not assume .mp3 when saving it.

Authorizations

Authorization
string
header
required

🔑 API Authentication

All endpoints require authentication using Bearer Token.

Get API Key

  1. Visit the API Key Management Page to obtain your API Key

Usage

Add to request headers:

⚠️ Note:

  • Keep your API Key secure and do not share it with others
  • If you suspect your API Key has been compromised, reset it immediately from the management page

Query Parameters

task_id
string
required

The recovery task ID returned by the Recovery Audio endpoint.

Response

Request successful

code
enum<integer>

Status Codes

  • ✅ 200 - Recovery finished, at least one track recovered successfully
  • ⏳ 201 - Recovery task is still running, keep polling
  • ⚠️ 400 - Invalid parameters
  • ⚠️ 401 - Unauthorized access
  • ⚠️ 404 - Invalid request method or path
  • ⚠️ 405 - Rate limit exceeded
  • ⚠️ 429 - Insufficient credits
  • ⚠️ 430 - Your call frequency is too high. Please try again later.
  • ⚠️ 455 - System maintenance
  • ❌ 500 - Recovery task failed or server error
Available options:
200,
201,
400,
401,
404,
405,
429,
430,
455,
500
Example:

200

task_id
string

Recovery task ID.

Example:

"bbbb****0f7b"

msg
string

Result message

Example:

"success"

data
object[] | null

Recovery result of each track. Returns null while the task is still running.