---
title: "Record Account Eligibility"
method: POST
path: "/v1/account/eligibility"
---

# Record Account Eligibility

`POST /v1/account/eligibility`

## Request

- Base URL: `https://api.lyricpatch.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lyricpatch.com/v1/account/eligibility`
- Auth: HTTP bearer

Record the authenticated 18+ clickwrap before age-gated API access.

The browser can call this only after Supabase authentication. It does not
grant credits; the separate promotional-credit route still requires a fresh
Turnstile verification.

## Headers

- `x-dev-user-id` string, nullable
- `x-dev-email` string, nullable

## Request body

- EligibilityRequest
  - `age_attested` true, required
  - `legal_version` string, required

## Response `200`

Successful Response

- AccountResponse
  - `user_id` string, uuid, required
  - `credit_balance` integer, required
  - `pro` object, nullable
  - `export_credit_cost` integer
  - `promotional_credits_expires_at` string, date-time, nullable, required
  - `legal_version` string, required
  - `private_beta_access` boolean
  - `welcome_offer_id` string, nullable
  - `welcome_credits` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/lyricpatch/apis/lyricpatch-api.md) · [All operations](https://skmtc.dev/lyricpatch/apis/lyricpatch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lyricpatch/apis/lyricpatch-api/revisions/307fbddfa9b0?raw)