---
title: "List the likeness approvals this account holds."
method: GET
path: "/likeness-consents"
tags: ["Voices"]
---

# List the likeness approvals this account holds.

`GET /likeness-consents`

## Request

- Base URL: `https://docs.sleeperhit.studio/api/v1`
- URL: `https://docs.sleeperhit.studio/api/v1/likeness-consents`
- Auth: HTTP bearer

A picture or video that would show a real, identifiable person who is living, or who died within the last 70 years, is made only while this account holds an active approval naming them (otherwise 422 `likeness_consent_required`). Fictional characters and long-dead historical figures need none, and nobody real is ever shown in a sexual or intimate way. Each approval says whose likeness it is, who approved (`self`: the account holder; `living_third_party`: the person; `estate`: a recently deceased person's estate), when, and whether it is `active` or `revoked`. Newest first.  Scope: `story:read`.

## Response `200`

The approvals.

- LikenessConsentList
  - `consents` StudioLikenessConsent[], required
    - `id` string, required
    - `subjectName` string, required: Whose likeness it is.
    - `subjectType` 'self' | 'living_third_party' | 'estate', required: `self`: the account holder; `living_third_party`: the person approved; `estate`: approved by a recently deceased person's estate.
    - `recordedAt` string, date-time, required
    - `revokedAt` string, date-time, nullable, required
    - `status` 'active' | 'revoked', required

## Other responses

- `401`: Missing, malformed, revoked, or expired API key.
- `403`: API key is valid but lacks the scope, is blocked by IP allowlist, or the account is disabled.
- `429`: Rate limit for this API key + IP + route family was exceeded.
- `500`: The API failed unexpectedly. Safe to retry with the same Idempotency-Key.

---

[API](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api.md) · [All operations](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api/revisions/64c1102ccb2f?raw)