Paid Beta

RightsDocket Claim API

The Claim API gives paid beta customers a keyed interface for validating AI-assisted authorship disclosures, estimating filing readiness, generating USCO-ready claim language, and reading stored RightsDocket claim records.

Authentication

All Claim API routes require a Claim API key.

  • Authorization: Bearer <claim-api-key>
  • x-api-key: <claim-api-key>

Keys are created, listed, revoked, and rotated from the authenticated in-app console. Plaintext keys are shown once, only at creation or rotation time.

Beta access

Claim API beta requires an active Pro subscription.

Pro plans include a monthly Claim API quota for programmatic access.

Signed-in customers can manage keys and view usage from /settings/claim-api.

Endpoints

POST/api/v1/claims/generate

Generate USCO filing language and readiness output

POST/api/v1/claims/validate

Validate input and preview errors, warnings, and readiness

POST/api/v1/claims/readiness

Return readiness-only output without the full claim package

GET/api/v1/claims/{id}

Read the stored claim record for a project ID or docket ID

GET/api/v1/openapi

Fetch the live OpenAPI spec for the beta

Generate example

{
  "humanContributions": [
    "lyrics",
    "melody"
  ],
  "aiContributions": [
    "production"
  ],
  "additionalNotes": "Human team rewrote the final lyrical phrasing and arrangement.",
  "context": {
    "mode": "RETROACTIVE",
    "creationDate": "2026-03-10T00:00:00.000Z",
    "rightsPosture": "Work for Hire",
    "generativeTools": "Suno v4, manual DAW editing",
    "contributors": [
      {
        "name": "Ari Lane",
        "role": "Writer",
        "percent": 60
      },
      {
        "name": "Noa Price",
        "role": "Producer",
        "percent": 40
      }
    ],
    "aiUsages": [
      {
        "vendor": "OpenAI",
        "tool": "Prompted ideation",
        "purpose": "initial hook exploration"
      }
    ],
    "attachments": [
      {
        "filename": "session.wav",
        "mimeType": "audio/wav",
        "category": "audio",
        "createdAt": "2026-03-10T12:00:00.000Z"
      }
    ]
  }
}

cURL example

curl -X POST https://your-rightsdocket-host/api/v1/claims/generate \
  -H "Authorization: Bearer rdc_your_claim_api_key" \
  -H "Content-Type: application/json" \
  -d '{"humanContributions":["lyrics","melody"],"aiContributions":["production"],"additionalNotes":"Human team rewrote the final lyrical phrasing and arrangement.","context":{"mode":"RETROACTIVE","creationDate":"2026-03-10T00:00:00.000Z","rightsPosture":"Work for Hire","generativeTools":"Suno v4, manual DAW editing","contributors":[{"name":"Ari Lane","role":"Writer","percent":60},{"name":"Noa Price","role":"Producer","percent":40}],"aiUsages":[{"vendor":"OpenAI","tool":"Prompted ideation","purpose":"initial hook exploration"}],"attachments":[{"filename":"session.wav","mimeType":"audio/wav","category":"audio","createdAt":"2026-03-10T12:00:00.000Z"}]}}'

The OpenAPI document at /api/v1/openapi is live and requires a valid Claim API key.