# List music generation jobs

List the authenticated user's music generation jobs for an organization, newest first. Optionally filter by status.

Returns a paginated page of the caller's generation jobs. Playback URLs and track summaries are omitted in the list view — fetch a single job to mint a signed playback URL.

## Path parameters

**`organization_id`** string required

The organization the jobs are scoped to. The caller must belong to it.

## Query parameters

**`status`** string optional

Filter by job status (`queued`, `running`, `succeeded`, `failed`, `cancelled`, `refused`).

**`limit`** integer optional · Defaults to `50`

Maximum number of jobs to return (1–100).

**`offset`** integer optional · Defaults to `0`

Number of jobs to skip before this page.

## Returns

An object with the page of jobs and its pagination window.

**`jobs`** array · Generation job objects for the caller, newest first.

**`limit`** integer · Maximum number of jobs returned in this page.

**`offset`** integer · Number of jobs skipped before this page.

Each job object contains:

**`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 · Always `null` in the list view.

**`track`** object · Always `null` in the list view.

Example

```bash cURL
curl "https://api.aitronos.com/v1/music/org_abc123/generations?status=succeeded&limit=20" \
  -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")

page = client.get(
    "/v1/music/org_abc123/generations",
    params={"status": "succeeded", "limit": 20},
)
for job in page["jobs"]:
    print(job["id"], job["status"])
```


```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",
    headers={"X-API-Key": api_key},
    params={"status": "succeeded", "limit": 20},
)
for job in response.json()["jobs"]:
    print(job["id"], job["status"])
```


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

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

const { jobs } = await response.json();
jobs.forEach(j => console.log(j.id, j.status));
```

**Response:**


```json 200 OK
{
  "jobs": [
    {
      "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": null,
      "track": null
    }
  ],
  "limit": 20,
  "offset": 0
}
```

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 403 Forbidden
{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_PERMISSIONS",
    "message": "You do not have permission to access this resource.",
    "system_message": "USE_MUSIC_GENERATION capability required",
    "type": "authorization_error",
    "status": 403,
    "details": {},
    "trace_id": "req_def456uvw",
    "timestamp": "2026-06-28T10:30:00Z"
  }
}
```

## Related Resources

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