Retrieve running jobs

November 14, 2026

Table of contents

  1. Request Headers
  2. Responses
  3. Model
  4. Examples
  5. Try It

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}
Responses

  • 200 OK

    {
  "jobs": [
    {
      "jobid": "j1114202212045711826m-u1234-email:[email protected]:so_8c1d4f7a2b9e4c06a3f5d7e1.so_e2a7b9c4d6f84a1b95c3e0d8-bot:acemusic",
      "type": "music",
      "status": "processing",
      "email": "[email protected]",
      "created": "2026-11-14T20:22:12.045Z",
      "model": "acemusic-v1",
      "modelUsed": "acemusic-v1",
      "replyUrl": "https://your-domain.com/webhook",
      "replyRef": "lofi-1"
    },
    {
      "jobid": "j1114202301338470152s-u1234-email:[email protected]:so_5a0e3c8b1d7f4e92a6c4b8d0.2-bot:acemusic",
      "type": "stems",
      "status": "processing",
      "email": "[email protected]",
      "created": "2026-11-14T20:23:01.338Z",
      "stemsMode": "all"
    }
  ]
}

    Nothing running:

    {
  "jobs": []
}

  • 401 Unauthorized

    Invalid API token.

    {
  "error": "useapi.net ⁝ Unauthorized",
  "code": 401
}
Model 
{ // TypeScript, all fields are optional
  jobs: {
    jobid: string
    type: 'music' | 'stems'
    status: 'processing'
    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' // stems
    replyUrl?: string
    replyRef?: string
  }[]
}
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())
Try It