API reference

The full REST API reference lives at api.realific.app/docs.

The complete, always-current reference (OpenAPI 3.1) is at api.realific.app/docs. The raw spec is at api.realific.app/openapi.json.

Authentication

Create an API key in Workspace settings → API keys and send it as Authorization: Bearer rf_live_…. Scopes: stats:read, events:write, sites:write, payments:write.

Example

curl "https://api.realific.app/v1/stats/aggregate?site_id=SITE_ID&from=2026-10-01&to=2026-10-31" \
  -H "Authorization: Bearer rf_live_…"

Rate limit: 600 requests per minute per key (X-RateLimit-* headers).