Retrieve running jobs

November 14, 2026 (November 16, 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: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": []
    }
    
  • 401 Unauthorized

    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())
    
Try It