Changelog

This page lists every meaningful change to the /api/v1/data/* surface. Subscribe by watching this URL or by polling /openapi.json for schema diffs.

Conventions: Added for new capabilities, Changed for backwards-compatible adjustments, Deprecated for things scheduled for removal (with sunset date), Removed when a sunset actually fires, Fixed for bug fixes that may visibly change output.

2026-06-04

Added — Public OpenAPI schema published at https://api.clarifo.com/openapi.json. Generate clients with any OpenAPI 3.x tool (openapi-generator, swagger-codegen, fern, etc.).

Added — API stability & versioning policy documenting the v1 backwards-compatibility contract and the deprecation flow (≥6 months notice, Deprecation + Sunset headers).

Added — Idempotency-Key header is now honoured on all POST endpoints (/filings/search, /filings/content-search, /companies/compare, /companies/screen). Sending the same key with the same body within 24 hours replays the original response without re-running the work or consuming additional quota.

Added — clf_test_… keys, separate from clf_live_…, for development against the same data without burning your production quota. Both prefixes are honoured by the same endpoints; usage is counted in two independent monthly buckets.

Added — Quota notification emails at 80 %, 95 %, and 100 % of the monthly limit. Sent at most once per threshold per calendar month per key. Plain transactional mail from support@clarifo.com — no configuration needed.

Added — Per-call audit trail in the API Keys settings page. The last ~50 calls per key now show endpoint, status, response time, source IP, and user agent. Useful for verifying integration health and detecting key leakage.

Added — Per-endpoint usage breakdown and 30-day call-volume chart in the API Keys settings page.

Changed — Browser-based clients on any origin can now call /api/v1/data/* directly. CORS is open for this surface (your clf_ key is the only gate); the rest of app.clarifo.com keeps its strict origin whitelist.

Earlier

The API has been in invite-only beta since early 2026. Prior to 2026-06-04, schema changes were communicated by email to active testers; from this date forward, every change lands here.

If you integrated before 2026-06-04 and want a written diff of what your client was built against versus today's contract, email support@clarifo.com with your key prefix and we'll send one.