List license drafts

cURL

: "${REFLECTIONS_KEY:?Set REFLECTIONS_KEY before running this example}"

curl --fail-with-body --max-time 30 'https://app.reflections.ai/v1/license_drafts?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/license_drafts?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/license_drafts?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/license_drafts?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": "ldr_tw5hx5mq8q0j5wry9hp32ftj0p",
      "object": "license_draft",
      "livemode": true,
      "status": "signed",
      "kind": "issue",
      "talent": "tal_9t0wxyhk5zba2q8v1m3n7p4r6s",
      "licensee": "acct_2q8v1m3n7p4r6s9t0wxyhk5zba",
      "license": "lic_k5zba2q8v1m3n7p4r6s9t0wxyh",
      "license_request": null,
      "scope": {
        "facets": [
          "fct_5zba2q8v1m3n7p4r6s9t0wxyhk"
        ],
        "modalities": [
          "image"
        ],
        "kinds": [
          "depiction"
        ],
        "purposes": [
          "advertising"
        ],
        "commercial": true,
        "channels": [
          "social",
          "web"
        ],
        "territories": [
          "US",
          "CA"
        ],
        "window": {
          "starts_at": "2026-10-01T00:00:00-04:00",
          "ends_at": "2027-03-31T00:00:00-04:00",
          "time_zone": "America/New_York"
        },
        "adjustments": {
          "reframe": true,
          "background_extension": true,
          "lighting": true,
          "text_overlay": true,
          "body_and_age": false,
          "expression": false,
          "hair": false,
          "pose": false,
          "wardrobe": true,
          "objects": true,
          "skin_retouch": false,
          "endorsement": false
        },
        "prohibited_changes": [
          "body_and_age",
          "expression",
          "hair",
          "pose",
          "skin_retouch",
          "endorsement"
        ],
        "required_attributes": [
          "identity.samePerson",
          "appearance.bodyAndAge",
          "appearance.expression",
          "appearance.hair",
          "appearance.pose",
          "appearance.skinRetouch",
          "context.endorsement"
        ],
        "rules": {
          "never": [
            "Do not show alcohol or tobacco."
          ],
          "always": [],
          "brief": null
        },
        "release_policy": "per_output_review",
        "escalation_window": "P7D",
        "final_deliverables": 24,
        "sessions": {
          "permitted": false
        },
        "material_access": [],
        "platforms": {
          "mode": "any_connected",
          "accounts": []
        },
        "sublicense": "none",
        "training": "prohibited",
        "disclosure": "brand",
        "attribution": null,
        "post_revocation": {
          "policy": "retain"
        },
        "exclusivity": {
          "exclusive": false,
          "category": null
        },
        "conflicts": [],
        "compensation": {
          "type": "per_unit",
          "per_unit": {
            "units": "placements",
            "rate": {
              "amount": 25000,
              "currency": "usd"
            },
            "per": 1
          },
          "minimum": {
            "amount": 500000,
            "currency": "usd"
          },
          "schedule": "monthly"
        }
      },
      "terms_digest": "sha256:39f18c8bef02b5226b9feaa92e526ed30b81b91650d8a10b503281b169f44431",
      "signer": "talent",
      "signing_url": null,
      "signed_as_drafted": true,
      "license_revision": "lrv_p4r6s9t0wxyhk5zba2q8v1m3n7",
      "decision_note": null,
      "note": "Social and Ridgeline's own website only. TV needs a separate license.",
      "created_by": "acct_6m8n0p2q4r6s8t0v2w4x6y8z0b",
      "expires_at": "2026-10-24T16:10:00Z",
      "signed_at": "2026-09-27T11:15:00Z",
      "declined_at": null,
      "metadata": {
        "deal_id": "RDG-FW26-014"
      },
      "created_at": "2026-09-24T16:10:00Z"
    },
    {
      "id": "ldr_dj05ema2gyfqqr7b22qj9ncm94",
      "object": "license_draft",
      "livemode": true,
      "status": "declined",
      "kind": "issue",
      "talent": "tal_9t0wxyhk5zba2q8v1m3n7p4r6s",
      "licensee": "acct_2q8v1m3n7p4r6s9t0wxyhk5zba",
      "license": null,
      "license_request": null,
      "scope": {
        "facets": [
          "fct_5zba2q8v1m3n7p4r6s9t0wxyhk"
        ],
        "modalities": [
          "image"
        ],
        "kinds": [
          "depiction"
        ],
        "purposes": [
          "advertising"
        ],
        "commercial": true,
        "channels": [
          "social",
          "web"
        ],
        "territories": [
          "US",
          "CA"
        ],
        "window": {
          "starts_at": "2026-10-01T00:00:00-04:00",
          "ends_at": "2027-03-31T00:00:00-04:00",
          "time_zone": "America/New_York"
        },
        "adjustments": {
          "reframe": true,
          "background_extension": true,
          "lighting": true,
          "text_overlay": true,
          "body_and_age": false,
          "expression": false,
          "hair": false,
          "pose": false,
          "wardrobe": true,
          "objects": true,
          "skin_retouch": false,
          "endorsement": false
        },
        "prohibited_changes": [
          "body_and_age",
          "expression",
          "hair",
          "pose",
          "skin_retouch",
          "endorsement"
        ],
        "required_attributes": [
          "identity.samePerson",
          "appearance.bodyAndAge",
          "appearance.expression",
          "appearance.hair",
          "appearance.pose",
          "appearance.skinRetouch",
          "context.endorsement"
        ],
        "rules": {
          "never": [
            "Do not show alcohol or tobacco."
          ],
          "always": [],
          "brief": null
        },
        "release_policy": "per_output_review",
        "escalation_window": "P7D",
        "final_deliverables": 24,
        "sessions": {
          "permitted": false
        },
        "material_access": [],
        "platforms": {
          "mode": "any_connected",
          "accounts": []
        },
        "sublicense": "none",
        "training": "prohibited",
        "disclosure": "brand",
        "attribution": null,
        "post_revocation": {
          "policy": "retain"
        },
        "exclusivity": {
          "exclusive": false,
          "category": null
        },
        "conflicts": [],
        "compensation": {
          "type": "per_unit",
          "per_unit": {
            "units": "placements",
            "rate": {
              "amount": 25000,
              "currency": "usd"
            },
            "per": 1
          },
          "minimum": {
            "amount": 500000,
            "currency": "usd"
          },
          "schedule": "monthly"
        }
      },
      "terms_digest": "sha256:39f18c8bef02b5226b9feaa92e526ed30b81b91650d8a10b503281b169f44431",
      "signer": "talent",
      "signing_url": null,
      "signed_as_drafted": null,
      "license_revision": null,
      "decision_note": "Send me Ridgeline's shot list first. I want to see the scenes before I sign.",
      "note": "Social and web in the US and Canada, October to March.",
      "created_by": "acct_6m8n0p2q4r6s8t0v2w4x6y8z0b",
      "expires_at": "2026-10-22T14:45:00Z",
      "signed_at": null,
      "declined_at": "2026-09-23T10:40:00Z",
      "metadata": {
        "deal_id": "RDG-FW26-014"
      },
      "created_at": "2026-09-22T14:45:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "bGRyX2RqMDVlbWEyZ3lm…"
}

{
  "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>"
}

GET

license_drafts

cURL

: "${REFLECTIONS_KEY:?Set REFLECTIONS_KEY before running this example}"

curl --fail-with-body --max-time 30 'https://app.reflections.ai/v1/license_drafts?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/license_drafts?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/license_drafts?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/license_drafts?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": "ldr_tw5hx5mq8q0j5wry9hp32ftj0p",
      "object": "license_draft",
      "livemode": true,
      "status": "signed",
      "kind": "issue",
      "talent": "tal_9t0wxyhk5zba2q8v1m3n7p4r6s",
      "licensee": "acct_2q8v1m3n7p4r6s9t0wxyhk5zba",
      "license": "lic_k5zba2q8v1m3n7p4r6s9t0wxyh",
      "license_request": null,
      "scope": {
        "facets": [
          "fct_5zba2q8v1m3n7p4r6s9t0wxyhk"
        ],
        "modalities": [
          "image"
        ],
        "kinds": [
          "depiction"
        ],
        "purposes": [
          "advertising"
        ],
        "commercial": true,
        "channels": [
          "social",
          "web"
        ],
        "territories": [
          "US",
          "CA"
        ],
        "window": {
          "starts_at": "2026-10-01T00:00:00-04:00",
          "ends_at": "2027-03-31T00:00:00-04:00",
          "time_zone": "America/New_York"
        },
        "adjustments": {
          "reframe": true,
          "background_extension": true,
          "lighting": true,
          "text_overlay": true,
          "body_and_age": false,
          "expression": false,
          "hair": false,
          "pose": false,
          "wardrobe": true,
          "objects": true,
          "skin_retouch": false,
          "endorsement": false
        },
        "prohibited_changes": [
          "body_and_age",
          "expression",
          "hair",
          "pose",
          "skin_retouch",
          "endorsement"
        ],
        "required_attributes": [
          "identity.samePerson",
          "appearance.bodyAndAge",
          "appearance.expression",
          "appearance.hair",
          "appearance.pose",
          "appearance.skinRetouch",
          "context.endorsement"
        ],
        "rules": {
          "never": [
            "Do not show alcohol or tobacco."
          ],
          "always": [],
          "brief": null
        },
        "release_policy": "per_output_review",
        "escalation_window": "P7D",
        "final_deliverables": 24,
        "sessions": {
          "permitted": false
        },
        "material_access": [],
        "platforms": {
          "mode": "any_connected",
          "accounts": []
        },
        "sublicense": "none",
        "training": "prohibited",
        "disclosure": "brand",
        "attribution": null,
        "post_revocation": {
          "policy": "retain"
        },
        "exclusivity": {
          "exclusive": false,
          "category": null
        },
        "conflicts": [],
        "compensation": {
          "type": "per_unit",
          "per_unit": {
            "units": "placements",
            "rate": {
              "amount": 25000,
              "currency": "usd"
            },
            "per": 1
          },
          "minimum": {
            "amount": 500000,
            "currency": "usd"
          },
          "schedule": "monthly"
        }
      },
      "terms_digest": "sha256:39f18c8bef02b5226b9feaa92e526ed30b81b91650d8a10b503281b169f44431",
      "signer": "talent",
      "signing_url": null,
      "signed_as_drafted": true,
      "license_revision": "lrv_p4r6s9t0wxyhk5zba2q8v1m3n7",
      "decision_note": null,
      "note": "Social and Ridgeline's own website only. TV needs a separate license.",
      "created_by": "acct_6m8n0p2q4r6s8t0v2w4x6y8z0b",
      "expires_at": "2026-10-24T16:10:00Z",
      "signed_at": "2026-09-27T11:15:00Z",
      "declined_at": null,
      "metadata": {
        "deal_id": "RDG-FW26-014"
      },
      "created_at": "2026-09-24T16:10:00Z"
    },
    {
      "id": "ldr_dj05ema2gyfqqr7b22qj9ncm94",
      "object": "license_draft",
      "livemode": true,
      "status": "declined",
      "kind": "issue",
      "talent": "tal_9t0wxyhk5zba2q8v1m3n7p4r6s",
      "licensee": "acct_2q8v1m3n7p4r6s9t0wxyhk5zba",
      "license": null,
      "license_request": null,
      "scope": {
        "facets": [
          "fct_5zba2q8v1m3n7p4r6s9t0wxyhk"
        ],
        "modalities": [
          "image"
        ],
        "kinds": [
          "depiction"
        ],
        "purposes": [
          "advertising"
        ],
        "commercial": true,
        "channels": [
          "social",
          "web"
        ],
        "territories": [
          "US",
          "CA"
        ],
        "window": {
          "starts_at": "2026-10-01T00:00:00-04:00",
          "ends_at": "2027-03-31T00:00:00-04:00",
          "time_zone": "America/New_York"
        },
        "adjustments": {
          "reframe": true,
          "background_extension": true,
          "lighting": true,
          "text_overlay": true,
          "body_and_age": false,
          "expression": false,
          "hair": false,
          "pose": false,
          "wardrobe": true,
          "objects": true,
          "skin_retouch": false,
          "endorsement": false
        },
        "prohibited_changes": [
          "body_and_age",
          "expression",
          "hair",
          "pose",
          "skin_retouch",
          "endorsement"
        ],
        "required_attributes": [
          "identity.samePerson",
          "appearance.bodyAndAge",
          "appearance.expression",
          "appearance.hair",
          "appearance.pose",
          "appearance.skinRetouch",
          "context.endorsement"
        ],
        "rules": {
          "never": [
            "Do not show alcohol or tobacco."
          ],
          "always": [],
          "brief": null
        },
        "release_policy": "per_output_review",
        "escalation_window": "P7D",
        "final_deliverables": 24,
        "sessions": {
          "permitted": false
        },
        "material_access": [],
        "platforms": {
          "mode": "any_connected",
          "accounts": []
        },
        "sublicense": "none",
        "training": "prohibited",
        "disclosure": "brand",
        "attribution": null,
        "post_revocation": {
          "policy": "retain"
        },
        "exclusivity": {
          "exclusive": false,
          "category": null
        },
        "conflicts": [],
        "compensation": {
          "type": "per_unit",
          "per_unit": {
            "units": "placements",
            "rate": {
              "amount": 25000,
              "currency": "usd"
            },
            "per": 1
          },
          "minimum": {
            "amount": 500000,
            "currency": "usd"
          },
          "schedule": "monthly"
        }
      },
      "terms_digest": "sha256:39f18c8bef02b5226b9feaa92e526ed30b81b91650d8a10b503281b169f44431",
      "signer": "talent",
      "signing_url": null,
      "signed_as_drafted": null,
      "license_revision": null,
      "decision_note": "Send me Ridgeline's shot list first. I want to see the scenes before I sign.",
      "note": "Social and web in the US and Canada, October to March.",
      "created_by": "acct_6m8n0p2q4r6s8t0v2w4x6y8z0b",
      "expires_at": "2026-10-22T14:45:00Z",
      "signed_at": null,
      "declined_at": "2026-09-23T10:40:00Z",
      "metadata": {
        "deal_id": "RDG-FW26-014"
      },
      "created_at": "2026-09-22T14:45:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "bGRyX2RqMDVlbWEyZ3lm…"
}

{
  "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

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"

Query Parameters

talent

string

Only drafts for this talent.

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

status

enum<string>

Only drafts with this status. open: waiting for a signature at signing_url. signed: signed; license and license_revision name the result. declined: the signer declined it. discarded: you discarded it, or the mandate ended. expired: not signed by expires_at.

Available options:

open,

signed,

declined,

discarded,

expired

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 drafts.

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 drafts on this page.

Show child attributes

Overview

Account

Talent

Facets

Resolutions

Licenses

License requests

Connections

Files

Checks

Generations

Sessions

Receipts

Verifications

Revocations

Usage records

Statements

Mandates

Escalations

License drafts

Webhook endpoints

Events

Discovery

OAuth

Test helpers

Webhooks

Real-time

Formats

MCP

Authorizations

Headers

Query Parameters

Response