Everything you need to add entitlements, usage metering, and billing-aware webhooks to your product — from your first API call to production operations.
Start here
Getting Started
Core concepts, authentication, and a runnable first API call.
Start learningQuickstarts
Pick your framework and run the full happy path in minutes.
Choose a frameworkGuides
Implementation patterns for entitlements, caching, metering, and webhooks.
Browse guidesTools & SDKs
The CLI, official SDKs, Postman collection, and AI-assistant integrations.
Browse toolsExplore guides
Complete, standalone references for the parts of the platform you'll integrate with most.
Entitlement patterns
Boolean gates, limit checks, and metered entitlements — the verdict model, resolution layering, and caching-safe recheck triggers.
Open guideCaching
What the API marks as cacheable, what to cache yourself, and the invalidation events that keep both layers correct.
Open guideMetering best practices
Idempotent usage submission, batching high-frequency meters, threshold UX, and drift reconciliation.
Open guideWebhook verification and retries
Register endpoints, verify signatures against the raw body, and process retried deliveries idempotently.
Open guideMigration guide
URL-path versioning, deprecation detection, dual-read fallbacks, and staged rollouts for breaking changes.
Open guideAudit and trace
Propagate request IDs end-to-end and correlate API activity, webhook deliveries, and the audit log.
Open guideEvents & Webhook Explorer
Browse every webhook event type with sample payloads, and verify signatures interactively.
Open guideNode SDK integration
Enriched decisions with reason codes, batch checks, caching with explicit degradation, credit reservations, and the SDK's two extension points.
Open guideClerk identity integration
Connect your Clerk instance to sync users and organizations as customers, then resolve sessions to customer ids on every request.
Open guidePostHog packaging analytics
Stream entitlement denials into your PostHog project — with explicit identity mapping, volume caps, and a preview of every event before anything is sent.
Open guideOpenTelemetry visibility
One-line decision spans and bounded metrics on your existing OTel setup, with a deep link from every span to the exact evaluation record.
Open guideExplore by framework
Framework-specific quickstarts with deploy and smoke-test instructions.
Next.js
TypeScript
Open quickstartExpress
JavaScript
Open quickstartFastAPI
Python
Open quickstartGo
Go
Open quickstartSpring
Java
Open quickstartAPI & GraphQL reference
Once you know what you're integrating, dig into the full endpoint and schema reference.
API Reference
Browse every REST operation, inspect schemas, run requests, and copy generated snippets.
Open referenceGraphQL Explorer
Browse the complete GraphQL schema and run operations against the interactive explorer.
Open referenceTroubleshooting
Diagnose common integration and runtime problems.
Error Codes
Reference for common API failures and remediation steps.
Open recovery guideAuth and Permission Issues
Diagnose invalid keys, scope mismatches, and token lifecycle issues.
Open recovery guideWebhook Delivery Issues
Fix signature mismatches, timeout failures, and endpoint availability problems.
Open recovery guideMetering and Usage Anomalies
Identify duplicate events, missing events, and threshold misconfiguration.
Open recovery guide