: "${REFLECTIONS_KEY:?Set REFLECTIONS_KEY before running this example}"
curl --fail-with-body --max-time 30 'https://app.reflections.ai/v1/statements?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/statements?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/statements?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/statements?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": "stmt_3d5f7h9k1m3p5r7t9w1y3a5c7e",
"object": "statement",
"livemode": true,
"license": "lic_ba2q8v1m3n7p4r6s9t0wxyhk5z",
"talent": "tal_9t0wxyhk5zba2q8v1m3n7p4r6s",
"licensee": "acct_7p4r6s9t0wxyhk5zba2q8v1m3n",
"status": "open",
"period": {
"start": "2026-10-01T00:00:00Z",
"end": "2026-11-01T00:00:00Z"
},
"currency": "usd",
"lines": [
{
"description": "Speech in Maya Okafor's voice",
"units": "seconds",
"reported": 18240,
"observed": 18262,
"billable": 18262,
"rate": {
"amount": 2,
"currency": "usd"
},
"amount": 36524
}
],
"amount_due": 36524,
"amount_paid": 0,
"reconciliation": {
"result": "under_reported",
"detail": "22 seconds observed in generations with no usage record."
},
"payments": [],
"due_at": null,
"issued_at": null,
"document_url": null,
"created_at": "2026-10-01T00:00:00Z"
},
{
"id": "stmt_5p7r9t1v3x5z7b9d1f3h5k7m9q",
"object": "statement",
"livemode": true,
"license": "lic_ba2q8v1m3n7p4r6s9t0wxyhk5z",
"talent": "tal_9t0wxyhk5zba2q8v1m3n7p4r6s",
"licensee": "acct_7p4r6s9t0wxyhk5zba2q8v1m3n",
"status": "paid",
"period": {
"start": "2026-09-01T00:00:00Z",
"end": "2026-10-01T00:00:00Z"
},
"currency": "usd",
"lines": [
{
"description": "Speech in Maya Okafor's voice",
"units": "seconds",
"reported": 41236,
"observed": 41236,
"billable": 41236,
"rate": {
"amount": 2,
"currency": "usd"
},
"amount": 82472
}
],
"amount_due": 82472,
"amount_paid": 82472,
"reconciliation": {
"result": "matched",
"detail": null
},
"payments": [
{
"id": "pay_sa9z70h0p3p3npjcjv3gfn3330",
"amount": 82472,
"paid_at": "2026-10-14T16:30:00Z",
"method": "bank_transfer",
"reference": "WIRE-58214",
"confirmed_at": "2026-10-16T09:00:00Z"
}
],
"due_at": "2026-10-31T00:00:00Z",
"issued_at": "2026-10-08T08:00:00Z",
"document_url": "https://app.reflections.ai/statements/stmt_5p7r9t1v3x5z7b9d1f3h5k7m9q",
"created_at": "2026-09-01T00:00: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 statements
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 statements for licenses you hold. A representative whose mandate has
receive_statements sees the talent’s statements.
Restricted keys need statements:read.
: "${REFLECTIONS_KEY:?Set REFLECTIONS_KEY before running this example}"
curl --fail-with-body --max-time 30 'https://app.reflections.ai/v1/statements?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/statements?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/statements?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/statements?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": "stmt_3d5f7h9k1m3p5r7t9w1y3a5c7e",
"object": "statement",
"livemode": true,
"license": "lic_ba2q8v1m3n7p4r6s9t0wxyhk5z",
"talent": "tal_9t0wxyhk5zba2q8v1m3n7p4r6s",
"licensee": "acct_7p4r6s9t0wxyhk5zba2q8v1m3n",
"status": "open",
"period": {
"start": "2026-10-01T00:00:00Z",
"end": "2026-11-01T00:00:00Z"
},
"currency": "usd",
"lines": [
{
"description": "Speech in Maya Okafor's voice",
"units": "seconds",
"reported": 18240,
"observed": 18262,
"billable": 18262,
"rate": {
"amount": 2,
"currency": "usd"
},
"amount": 36524
}
],
"amount_due": 36524,
"amount_paid": 0,
"reconciliation": {
"result": "under_reported",
"detail": "22 seconds observed in generations with no usage record."
},
"payments": [],
"due_at": null,
"issued_at": null,
"document_url": null,
"created_at": "2026-10-01T00:00:00Z"
},
{
"id": "stmt_5p7r9t1v3x5z7b9d1f3h5k7m9q",
"object": "statement",
"livemode": true,
"license": "lic_ba2q8v1m3n7p4r6s9t0wxyhk5z",
"talent": "tal_9t0wxyhk5zba2q8v1m3n7p4r6s",
"licensee": "acct_7p4r6s9t0wxyhk5zba2q8v1m3n",
"status": "paid",
"period": {
"start": "2026-09-01T00:00:00Z",
"end": "2026-10-01T00:00:00Z"
},
"currency": "usd",
"lines": [
{
"description": "Speech in Maya Okafor's voice",
"units": "seconds",
"reported": 41236,
"observed": 41236,
"billable": 41236,
"rate": {
"amount": 2,
"currency": "usd"
},
"amount": 82472
}
],
"amount_due": 82472,
"amount_paid": 82472,
"reconciliation": {
"result": "matched",
"detail": null
},
"payments": [
{
"id": "pay_sa9z70h0p3p3npjcjv3gfn3330",
"amount": 82472,
"paid_at": "2026-10-14T16:30:00Z",
"method": "bank_transfer",
"reference": "WIRE-58214",
"confirmed_at": "2026-10-16T09:00:00Z"
}
],
"due_at": "2026-10-31T00:00:00Z",
"issued_at": "2026-10-08T08:00:00Z",
"document_url": "https://app.reflections.ai/statements/stmt_5p7r9t1v3x5z7b9d1f3h5k7m9q",
"created_at": "2026-09-01T00:00: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"
Act for a connected licensee. The value is the licensee's account ID. Requires an active connection between that account and yours.
^acct_[0-9a-hjkmnp-tv-z]{26}$Query Parameters
Only statements for this talent's licenses.
^tal_[0-9a-hjkmnp-tv-z]{26}$Only statements for this license.
^lic_[0-9a-hjkmnp-tv-z]{26}$Only statements with this status, such as issued.
open: the month is still running. issued: final for the month. paid: the talent's side confirmed payment. disputed: the talent's side disputed it.
open, issued, paid, disputed Number of objects to return, 1 to 100.
1 <= x <= 100The next_cursor from the previous page.