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.
organization_id string required
The organization the jobs are scoped to. The caller must belong to it.
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.
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.
- Bash
- Python
- Python
- JavaScript
curl "https://api.aitronos.com/v1/music/org_abc123/generations?status=succeeded&limit=20" \
-H "X-API-Key: $FREDDY_API_KEY"Response:
{
"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
}