Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Your secret key, rk_test_… or rk_live_…, sent as Authorization: Bearer <key>. Keep it on your server. Restricted keys carry only the scopes you give them.

Headers

Reflections-Version
string

The dated API version. Defaults to the version your account is pinned to.

Example:

"2026-10-15"

Reflections-Account
string

Act for a connected licensee. The value is the licensee's account ID. Requires an active connection between that account and yours.

Pattern: ^acct_[0-9a-hjkmnp-tv-z]{26}$

Query Parameters

talent
string

Only generations checked for this talent.

Pattern: ^tal_[0-9a-hjkmnp-tv-z]{26}$
license
string

Only generations made under this license. Required in live mode.

Pattern: ^lic_[0-9a-hjkmnp-tv-z]{26}$
check
string

Only generations made under this check.

Pattern: ^chk_[0-9a-hjkmnp-tv-z]{26}$
status
enum<string>

Only generations with this status, such as held. checking: not decided yet. allowed: deliver. denied: never deliver. held: waiting for release. released: a reviewer released it; deliver. expired: never reviewed. withdrawn: you withdrew it.

Available options:
checking,
allowed,
denied,
held,
released,
expired,
withdrawn
release_status
enum<string>

Live mode only, with license: awaiting_release lists only the finals waiting for the talent to release or decline them. Test mode filters with status=held instead.

Available options:
awaiting_release
limit
integer
default:20

Number of objects to return, 1 to 100.

Required range: 1 <= x <= 100
cursor
string

The next_cursor from the previous page.

Response

A page of generations.

object
string
required

Always list.

Allowed value: "list"
has_more
boolean
required

Whether another page exists.

next_cursor
string | null

Pass as cursor to read the next page.

data
object[]

The generations on this page, newest first: generation objects in test mode, generation_summary objects in live mode.