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}$

Path Parameters

request_id
string
required

The license request's ID.

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

Response

The license request.

id
string
required

Unique identifier for the request, lrq_….

Pattern: ^lrq_[0-9a-hjkmnp-tv-z]{26}$
object
string
required

Always license_request.

Allowed value: "license_request"
livemode
boolean
required

true for a live-mode request, false for a test-mode one.

kind
enum<string>
required

new for a new license, or change for a new revision of license.

Available options:
new,
change
status
enum<string>
required

Where the request stands. Only a sent request can be withdrawn or declined.

Available options:
sent,
signed,
declined,
withdrawn
talent
string
required

The talent the request asks.

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

The account that would hold the license: the sender, or the connected licensee a platform sent it for.

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

The terms asked for, as sent.

created_at
string<date-time>
required

When the request was sent.

license
string | null

For change, the license to change. When signed, the license it became.

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

The revision the talent's side signed. It may differ from what you asked.

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

The denied check that prompted the request. null if none was named.

Pattern: ^chk_[0-9a-hjkmnp-tv-z]{26}$
offer
object | null

The compensation offered. null if the request made no offer.

note
string | null

The note to the talent, as written. null if none was sent.

decision_note
string | null

The talent's note when they declined or signed.

signed_at
string<date-time> | null

When the talent's side signed a license or revision from the request. null unless signed.

declined_at
string<date-time> | null

When the talent's side declined the request. null unless declined.

withdrawn_at
string<date-time> | null

When the licensee withdrew the request. null unless withdrawn.

metadata
object

The key-value pairs sent with the request.