Retrieve running jobs
November 14, 2026 (November 16, 2026)
Table of contents
List the song and stem-split jobs that are running now on all your ACE Music accounts. A job leaves the list as soon as it ends: read finished jobs with GET /jobs/jobid and their songs with GET /music.
Each account runs up to its maxJobs requests at a time (default 4). Count the jobs per email here to see which accounts are full when POST /music answers 429.
https://api.useapi.net/v1/acemusic/jobs
Request Headers
Authorization: Bearer {API token}
API tokenis required, see Setup useapi.net for details.
Responses
-
{ "jobs": [ { "jobid": "j1114202212045711826m-u1234-email:example@example.com-task:so_8c1d4f7a2b9e4c06a3f5d7e1.so_e2a7b9c4d6f84a1b95c3e0d8-bot:acemusic", "type": "music", "status": "processing", "email": "example@example.com", "created": "2026-11-14T20:22:12.045Z", "model": "acemusic-v1", "modelUsed": "acemusic-v1", "replyUrl": "https://your-domain.com/webhook", "replyRef": "lofi-1", "job_state": "in_progress", "outputs": [] }, { "jobid": "j1114202301338470152s-u1234-email:example2@example.com-task:so_5a0e3c8b1d7f4e92a6c4b8d0.2-bot:acemusic", "type": "stems", "status": "processing", "email": "example2@example.com", "created": "2026-11-14T20:23:01.338Z", "stemsMode": "all", "job_state": "in_progress", "outputs": [] } ] }Nothing running:
{ "jobs": [] } -
Invalid API token.
{ "error": "useapi.net ⁝ Unauthorized", "code": 401 }
Model
Your running jobs, newest first, each with the jobid to read with GET /jobs/jobid.
The running jobs, field by field
{ // TypeScript, all fields are optional
jobs: { // the running jobs of your token, newest first
jobid: string // read it with GET /jobs/{jobid}
type: 'music' | 'stems' // music: POST /music. stems: POST /music/stems
status: 'processing' // only running jobs are listed
email: string // the account the job runs on
created: string // ISO 8601
model?: string // music: the model asked for
modelUsed?: string // music: the model that runs
stemsMode?: 'vocals' | 'all' // on a stems job: the split asked for
replyUrl?: string // the replyUrl you sent
replyRef?: string // the replyRef you sent
job_state: 'in_progress' // where the job is, in the same words for every useapi.net API
outputs: [] // no files yet: the job is running
}[]
}
Examples
-
curl "https://api.useapi.net/v1/acemusic/jobs" \ -H "Authorization: Bearer …" -
const token = "API token"; const response = await fetch("https://api.useapi.net/v1/acemusic/jobs", { headers: { "Authorization": `Bearer ${token}` } }); console.log(response.status, await response.json()); -
import requests token = "API token" response = requests.get("https://api.useapi.net/v1/acemusic/jobs", headers={"Authorization": f"Bearer {token}"}) print(response.status_code, response.json())