Skip to main content
GET
List your generation history

Authorizations

X-Api-Key
string
header
required

Your team API key (starts with al_live_).

Headers

Aurous-Version
string

Optional API version pin (YYYY-MM-DD). Defaults to your team's pinned version, or the system default 2026-07-16 for unauthenticated requests.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-07-16"

Query Parameters

starting_after
string

Cursor — opaque ID; returns rows STRICTLY OLDER than this

Example:

"img_01HXMQ7Z3K8Y2ABCDEFGHJKM"

ending_before
string

Cursor — opaque ID; returns rows STRICTLY NEWER than this

Example:

"img_01HXMQ7Z3K8Y2ABCDEFGHJKM"

limit
number

Items per page (1–100, default 20)

Example:

20

Response

Cursor-paginated list of generations

object
enum<string>
required

Discriminator

Available options:
list
Example:

"list"

data
object[]
required

Array of GenerationResponse items

has_more
boolean
required

True when the next page exists

Example:

true

next_cursor
object | null

Pass as ?starting_after= on the next request. null when has_more is false.

Example:

"img_01HXMQ7Z3K8Y2ABCDEFGHJKM"