# Get a music generation job

Return a single generation job's status, progress, and — on success — a freshly-minted short-TTL signed playback URL for the master audio plus an embedded track summary.

Poll this endpoint to track a job to completion. The returned `playback_url` is minted on each request and expires quickly — re-fetch the job to mint a new one. Scoped to the caller's organization and user (IDOR-safe).

## Path parameters

**`organization_id`** string required

The organization the job is scoped to. The caller must belong to it.

**`job_id`** string required

Id of the generation job (`mgen_`-prefixed).

## Returns

A music generation job object. On success the `track` summary and `playback_url` are populated.

**`id`** string · Job id (`mgen_`-prefixed).

**`status`** string · One of `queued`, `running`, `succeeded`, `failed`, `cancelled`, `refused`.

**`progress`** integer · Generation progress, 0–100.

**`engine`** string · Internal engine key the job targets.

**`mode`** string · `creation` or `focus`.

**`created_at`** string · When the job was created (UTC).

**`result_track_id`** string · Id of the produced track once succeeded.

**`error_message`** string · User-safe error description when the job failed.

**`refusal_reason`** string · Reason the request was refused, when `status` is `refused`.

**`playback_url`** string · Short-TTL signed URL for the master audio, present only on a succeeded job.

**`track`** object · Embedded track summary (id, title, engine, mode, instrumental, `measured_duration_seconds`, `mime_type`, `licence_class`, `playback_url`), present only on a succeeded job.

Example

```bash cURL
curl "https://api.aitronos.com/v1/music/org_abc123/generations/mgen_2f8b1c4e9a7d" \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python Python SDK
from aitronos import Aitronos  # pip install aitronos-sdk

client = Aitronos(api_key="your-api-key")

job = client.get("/v1/music/org_abc123/generations/mgen_2f8b1c4e9a7d")
if job["status"] == "succeeded":
    print(job["playback_url"])
```


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]

response = requests.get(
    "https://api.aitronos.com/v1/music/org_abc123/generations/mgen_2f8b1c4e9a7d",
    headers={"X-API-Key": api_key},
)
job = response.json()
print(job["status"], job["progress"])
```


```javascript JavaScript
const apiKey = process.env.FREDDY_API_KEY;

const response = await fetch(
  'https://api.aitronos.com/v1/music/org_abc123/generations/mgen_2f8b1c4e9a7d',
  { headers: { 'X-API-Key': apiKey } }
);

const job = await response.json();
console.log(job.status, job.playback_url);
```

**Response:**


```json 200 OK
{
  "id": "mgen_2f8b1c4e9a7d",
  "status": "succeeded",
  "progress": 100,
  "engine": "studio",
  "mode": "creation",
  "created_at": "2026-06-28T10:30:00Z",
  "result_track_id": "mtrack_7c1a9e2f4b8d",
  "error_message": null,
  "refusal_reason": null,
  "playback_url": "https://storage.aitronos.com/music/mtrack_7c1a9e2f4b8d.mp3?sig=...",
  "track": {
    "id": "mtrack_7c1a9e2f4b8d",
    "title": "Late Night Study",
    "engine": "studio",
    "mode": "creation",
    "instrumental": true,
    "measured_duration_seconds": 119.4,
    "mime_type": "audio/mpeg",
    "licence_class": "personal_only",
    "playback_url": "https://storage.aitronos.com/music/mtrack_7c1a9e2f4b8d.mp3?sig=..."
  }
}
```

Errors

```json 401 Unauthorized
{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_REQUIRED",
    "message": "Authentication required. Please provide a valid API key.",
    "system_message": "Missing or invalid authorization header",
    "type": "authentication_error",
    "status": 401,
    "details": {},
    "trace_id": "req_abc123xyz",
    "timestamp": "2026-06-28T10:30:00Z"
  }
}
```


```json 404 Not Found
{
  "success": false,
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "The requested resource could not be found.",
    "system_message": "Music generation job not found",
    "type": "client_error",
    "status": 404,
    "details": { "job_id": "mgen_2f8b1c4e9a7d" },
    "trace_id": "req_jkl012mno",
    "timestamp": "2026-06-28T10:30:00Z"
  }
}
```

## Related Resources

- [Create a generation job](/docs/api-reference/music/create-generation)
- [List generation jobs](/docs/api-reference/music/list-generations)
- [Cancel a generation job](/docs/api-reference/music/cancel-generation)
- [Get a track](/docs/api-reference/music/get-track)