---
title: "Check a free audio job"
method: GET
path: "/api/agent/v1/audio-jobs/{jobId}"
tags: ["Free audio tools"]
---

# Check a free audio job

`GET /api/agent/v1/audio-jobs/{jobId}`

## Request

- Base URL: `https://nicevois.com`
- URL: `https://nicevois.com/api/agent/v1/audio-jobs/{jobId}`
- Auth: none required

Poll no more than every 10 seconds. When status is completed, outputs lists every file with a download link.

## Path parameters

- `jobId` string, required

## Response `200`

The job.

- AudioJob
  - `id` string, required
  - `tool` string, required
  - `toolName` string
  - `status` 'awaiting_upload' | 'running' | 'completed' | 'failed' | 'cancelled', required
  - `stage` string, nullable
  - `message` string, nullable
  - `error` string, nullable
  - `fileName` string, nullable
  - `durationSeconds` number, nullable
  - `createdAt` string, nullable
  - `price` 'free', required
  - `upload` object, nullable
    - `method` 'PUT', required
    - `url` string, uri, required
    - `headers` object, required
    - `receivedBytes` integer
  - `outputs` object[], required
    - `stem` string, required
    - `name` string, required
    - `description` string
    - `downloadUrl` string, uri, required
  - `pollAfterSeconds` integer, nullable
  - `websiteUrl` string, uri, required
  - `links` object, required
    - `status` string, uri

## Other responses

- `404`: No job has that id.

---

[API](https://skmtc.dev/nicevois/apis/nicevois-agent-api.md) · [All operations](https://skmtc.dev/nicevois/apis/nicevois-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nicevois/apis/nicevois-agent-api/revisions/6ef41022a089?raw)