: "${REFLECTIONS_KEY:?Set REFLECTIONS_KEY before running this example}"
curl --fail-with-body --max-time 30 'https://app.reflections.ai/v1/events?limit=10' \
-H "Authorization: Bearer $REFLECTIONS_KEY" \
-H "Reflections-Version: 2026-10-15"import { env, exit } from "node:process";
const apiKey = env.REFLECTIONS_KEY;
if (!apiKey) throw new Error("Set REFLECTIONS_KEY before running this example");
const response = await fetch("https://app.reflections.ai/v1/events?limit=10", {
method: "GET",
headers: {
Authorization: `Bearer ${apiKey}`,
"Reflections-Version": "2026-10-15",
},
signal: AbortSignal.timeout(30_000),
});
const responseBody = await response.text();
if (!response.ok) {
console.error(`HTTP ${response.status}: ${responseBody}`);
exit(1);
}
console.log(responseBody);
import os
from urllib.error import HTTPError
from urllib.request import Request, urlopen
apiKey = os.environ["REFLECTIONS_KEY"]
if not apiKey:
raise ValueError("Set REFLECTIONS_KEY before running this example")
headers = {
"Authorization": f"Bearer {apiKey}",
"Reflections-Version": "2026-10-15",
}
request = Request("https://app.reflections.ai/v1/events?limit=10",
method="GET", headers=headers)
try:
with urlopen(request, timeout=30) as response:
print(response.read().decode("utf-8"))
except HTTPError as error:
error_body = error.read().decode("utf-8")
raise RuntimeError(f"HTTP {error.code}: {error_body}") from error
package main
import (
"fmt"
"io"
"net/http"
"os"
"time"
)
func main() {
apiKey := os.Getenv("REFLECTIONS_KEY")
if apiKey == "" {
panic("Set REFLECTIONS_KEY before running this example")
}
request, err := http.NewRequest("GET", "https://app.reflections.ai/v1/events?limit=10", nil)
if err != nil {
panic(err)
}
request.Header.Set("Authorization", "Bearer " + apiKey)
request.Header.Set("Reflections-Version", "2026-10-15")
client := &http.Client{Timeout: 30 * time.Second}
response, err := client.Do(request)
if err != nil {
panic(err)
}
defer response.Body.Close()
responseBody, err := io.ReadAll(response.Body)
if err != nil {
panic(err)
}
if response.StatusCode < 200 || response.StatusCode >= 300 {
panic(fmt.Sprintf("HTTP %d: %s", response.StatusCode, responseBody))
}
fmt.Print(string(responseBody))
}
{
"object": "list",
"data": [
{
"id": "evt_72z7c0jm4ezmm1xzvtmp4j6tm4",
"object": "event",
"type": "mandate.ended",
"api_version": "2026-10-15",
"livemode": true,
"account": null,
"sequence": 2,
"created_at": "2026-10-29T13:02:11Z",
"data": {
"object": {
"id": "mnd_ww2cs3e4j5tgqqxs7mt7746q4p",
"object": "mandate",
"livemode": true,
"talent": "tal_4n6p8r0t2v4x6z8b0d2f4h6j8k",
"talent_name": "Jonah Reyes",
"representative": "acct_6m8n0p2q4r6s8t0v2w4x6y8z0b",
"role": "manager",
"powers": [
"issue_licenses",
"review_outputs",
"receive_statements"
],
"status": "ended",
"starts_at": "2026-10-05T15:20:00Z",
"ends_at": null,
"ended_at": "2026-10-29T13:02:10Z",
"revocation": "rvk_ch7rn89symf3em1rsp31ztxg9b",
"created_at": "2026-10-05T15:20:00Z"
},
"previous_attributes": {
"status": "active",
"ended_at": null,
"revocation": null
}
}
},
{
"id": "evt_td2daf8rebqk19qb6bbfss9j0w",
"object": "event",
"type": "mandate.created",
"api_version": "2026-10-15",
"livemode": true,
"account": null,
"sequence": 1,
"created_at": "2026-10-05T15:20:01Z",
"data": {
"object": {
"id": "mnd_ww2cs3e4j5tgqqxs7mt7746q4p",
"object": "mandate",
"livemode": true,
"talent": "tal_4n6p8r0t2v4x6z8b0d2f4h6j8k",
"talent_name": "Jonah Reyes",
"representative": "acct_6m8n0p2q4r6s8t0v2w4x6y8z0b",
"role": "manager",
"powers": [
"issue_licenses",
"review_outputs",
"receive_statements"
],
"status": "active",
"starts_at": "2026-10-05T15:20:00Z",
"ends_at": null,
"ended_at": null,
"revocation": null,
"created_at": "2026-10-05T15:20:00Z"
}
}
}
],
"has_more": false,
"next_cursor": null
}{
"type": "https://docs.reflections.ai/errors/parameter_invalid",
"title": "A parameter is invalid",
"status": 400,
"code": "parameter_invalid",
"param": "use.territories[1]",
"detail": "\"UK\" is not an ISO 3166-1 alpha-2 code. Use \"GB\".",
"request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}{
"type": "https://docs.reflections.ai/errors/invalid_api_key",
"title": "The API key is not valid",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}{
"type": "https://docs.reflections.ai/errors/account_not_connected",
"title": "The licensee has not connected your platform",
"status": 403,
"code": "account_not_connected",
"detail": "acct_2q8v1m3n7p4r6s9t0wxyhk5zba has no active connection with your account.",
"request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}{
"type": "https://docs.reflections.ai/errors/rate_limited",
"title": "Too many requests",
"status": 429,
"code": "rate_limited",
"request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "invalid_request",
"request_id": "<string>",
"detail": "<string>",
"param": "<string>",
"doc_url": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "invalid_request",
"request_id": "<string>",
"detail": "<string>",
"param": "<string>",
"doc_url": "<string>"
}List events
Planned contract — unavailable in test and live modes. This operation is a protocol reference, not a callable endpoint. Start with the working sandbox quickstart.
Lists events from the last 30 days, newest first, or oldest first after after.
Restricted keys need events:read.
: "${REFLECTIONS_KEY:?Set REFLECTIONS_KEY before running this example}"
curl --fail-with-body --max-time 30 'https://app.reflections.ai/v1/events?limit=10' \
-H "Authorization: Bearer $REFLECTIONS_KEY" \
-H "Reflections-Version: 2026-10-15"import { env, exit } from "node:process";
const apiKey = env.REFLECTIONS_KEY;
if (!apiKey) throw new Error("Set REFLECTIONS_KEY before running this example");
const response = await fetch("https://app.reflections.ai/v1/events?limit=10", {
method: "GET",
headers: {
Authorization: `Bearer ${apiKey}`,
"Reflections-Version": "2026-10-15",
},
signal: AbortSignal.timeout(30_000),
});
const responseBody = await response.text();
if (!response.ok) {
console.error(`HTTP ${response.status}: ${responseBody}`);
exit(1);
}
console.log(responseBody);
import os
from urllib.error import HTTPError
from urllib.request import Request, urlopen
apiKey = os.environ["REFLECTIONS_KEY"]
if not apiKey:
raise ValueError("Set REFLECTIONS_KEY before running this example")
headers = {
"Authorization": f"Bearer {apiKey}",
"Reflections-Version": "2026-10-15",
}
request = Request("https://app.reflections.ai/v1/events?limit=10",
method="GET", headers=headers)
try:
with urlopen(request, timeout=30) as response:
print(response.read().decode("utf-8"))
except HTTPError as error:
error_body = error.read().decode("utf-8")
raise RuntimeError(f"HTTP {error.code}: {error_body}") from error
package main
import (
"fmt"
"io"
"net/http"
"os"
"time"
)
func main() {
apiKey := os.Getenv("REFLECTIONS_KEY")
if apiKey == "" {
panic("Set REFLECTIONS_KEY before running this example")
}
request, err := http.NewRequest("GET", "https://app.reflections.ai/v1/events?limit=10", nil)
if err != nil {
panic(err)
}
request.Header.Set("Authorization", "Bearer " + apiKey)
request.Header.Set("Reflections-Version", "2026-10-15")
client := &http.Client{Timeout: 30 * time.Second}
response, err := client.Do(request)
if err != nil {
panic(err)
}
defer response.Body.Close()
responseBody, err := io.ReadAll(response.Body)
if err != nil {
panic(err)
}
if response.StatusCode < 200 || response.StatusCode >= 300 {
panic(fmt.Sprintf("HTTP %d: %s", response.StatusCode, responseBody))
}
fmt.Print(string(responseBody))
}
{
"object": "list",
"data": [
{
"id": "evt_72z7c0jm4ezmm1xzvtmp4j6tm4",
"object": "event",
"type": "mandate.ended",
"api_version": "2026-10-15",
"livemode": true,
"account": null,
"sequence": 2,
"created_at": "2026-10-29T13:02:11Z",
"data": {
"object": {
"id": "mnd_ww2cs3e4j5tgqqxs7mt7746q4p",
"object": "mandate",
"livemode": true,
"talent": "tal_4n6p8r0t2v4x6z8b0d2f4h6j8k",
"talent_name": "Jonah Reyes",
"representative": "acct_6m8n0p2q4r6s8t0v2w4x6y8z0b",
"role": "manager",
"powers": [
"issue_licenses",
"review_outputs",
"receive_statements"
],
"status": "ended",
"starts_at": "2026-10-05T15:20:00Z",
"ends_at": null,
"ended_at": "2026-10-29T13:02:10Z",
"revocation": "rvk_ch7rn89symf3em1rsp31ztxg9b",
"created_at": "2026-10-05T15:20:00Z"
},
"previous_attributes": {
"status": "active",
"ended_at": null,
"revocation": null
}
}
},
{
"id": "evt_td2daf8rebqk19qb6bbfss9j0w",
"object": "event",
"type": "mandate.created",
"api_version": "2026-10-15",
"livemode": true,
"account": null,
"sequence": 1,
"created_at": "2026-10-05T15:20:01Z",
"data": {
"object": {
"id": "mnd_ww2cs3e4j5tgqqxs7mt7746q4p",
"object": "mandate",
"livemode": true,
"talent": "tal_4n6p8r0t2v4x6z8b0d2f4h6j8k",
"talent_name": "Jonah Reyes",
"representative": "acct_6m8n0p2q4r6s8t0v2w4x6y8z0b",
"role": "manager",
"powers": [
"issue_licenses",
"review_outputs",
"receive_statements"
],
"status": "active",
"starts_at": "2026-10-05T15:20:00Z",
"ends_at": null,
"ended_at": null,
"revocation": null,
"created_at": "2026-10-05T15:20:00Z"
}
}
}
],
"has_more": false,
"next_cursor": null
}{
"type": "https://docs.reflections.ai/errors/parameter_invalid",
"title": "A parameter is invalid",
"status": 400,
"code": "parameter_invalid",
"param": "use.territories[1]",
"detail": "\"UK\" is not an ISO 3166-1 alpha-2 code. Use \"GB\".",
"request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}{
"type": "https://docs.reflections.ai/errors/invalid_api_key",
"title": "The API key is not valid",
"status": 401,
"code": "invalid_api_key",
"request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}{
"type": "https://docs.reflections.ai/errors/account_not_connected",
"title": "The licensee has not connected your platform",
"status": 403,
"code": "account_not_connected",
"detail": "acct_2q8v1m3n7p4r6s9t0wxyhk5zba has no active connection with your account.",
"request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}{
"type": "https://docs.reflections.ai/errors/rate_limited",
"title": "Too many requests",
"status": 429,
"code": "rate_limited",
"request_id": "req_8f2k4m6p8r0t2v4x6z8b0d2f4h"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "invalid_request",
"request_id": "<string>",
"detail": "<string>",
"param": "<string>",
"doc_url": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "invalid_request",
"request_id": "<string>",
"detail": "<string>",
"param": "<string>",
"doc_url": "<string>"
}Authorizations
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
The dated API version. Defaults to the version your account is pinned to.
"2026-10-15"
Query Parameters
Only events of this type. Use a prefix with *, such as license.*.
Return events created after this one, oldest first.
^evt_[0-9a-hjkmnp-tv-z]{26}$Number of objects to return, 1 to 100.
1 <= x <= 100The next_cursor from the previous page.
Response
A page of events.
Always list.
"list"Whether another page exists.
Pass as cursor to read the next page.
The events on this page: newest first, or oldest first when you pass after.
An event of any type. type names it, and data.object is the object that type carries.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
- Option 12
- Option 13
- Option 14
Show child attributes
Show child attributes