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"

Path Parameters

mandate_id
string
required

The mandate's ID.

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

Response

The mandate.

A talent's appointment of your account as their representative, with the powers they chose.

id
string
required

The mandate's ID, mnd_….

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

Always mandate.

Allowed value: "mandate"
livemode
boolean
required

true in live mode, false in test mode.

talent
string
required

The talent who appointed you.

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

The talent's name, for display.

representative
string
required

Your account.

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

The kind of representative the talent appointed you as. legal is legal counsel.

Available options:
agency,
manager,
estate,
union,
legal
powers
enum<string>[]
required

issue_licenses: draft licenses and answer license requests. review_outputs: resolve escalations and release held outputs. revoke: suspend, resume and revoke licenses. receive_statements: read statements, confirm payments and dispute statements.

Available options:
issue_licenses,
review_outputs,
revoke,
receive_statements
status
enum<string>
required

active while you may act for the talent. ended once the talent ended it or ends_at passed.

Available options:
active,
ended
starts_at
string<date-time>
required

When you may start acting for the talent.

created_at
string<date-time>
required

When the talent appointed you in the Talent Portal.

ends_at
string<date-time> | null

When the mandate ends on its own, if the talent set an end.

ended_at
string<date-time> | null

When the mandate ended. null while active.

revocation
string | null

The revocation with scope mandate that ended it, when the talent ended it.

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