Developers · API v1

Clearinghouse

Fetch the usage rules talents have set, check a use before generating content, and report monthly usage for invoicing.

Base URL: https://thepersonagrata.com/api/v1
Authorization: Bearer <your API key>   (only where marked)

GET/clearinghouse/rules?since={unix}API key

Feed of rule changes since a timestamp. Cache the result and poll regularly.

Current rules for one person.

Check a single use. use_type is one of face_generation, voice_generation, fan_content, advertising, ai_training, political_use.

{ "pg_id": "PG-7F3A9C", "use_type": "face_generation", "territory": "EU", "quantity": 1 }

{ "check_id": "CHK-…", "decision": "allowed | not_available | needs_approval | unknown_person", "price_cents": 50, "pricing_unit": "per_generation" }

Submit monthly usage as JSON lines or as CSV text. Download the CSV template below.

{ "period": "2026-10", "lines": [{ "pg_id": "PG-7F3A9C", "use_type": "face_generation", "quantity": 120, "pricing_unit": "per_generation" }] }

List your submitted reports and their status.

CSV template with the required columns.