License API Docs

Every endpoint except /v1/health requires an API key. Send it as a Bearer token (preferred) or X-API-Key header:

curl -s https://api.compcurve.com/v1/licenses?state=CA\&limit=5 \
  -H "Authorization: Bearer cck_YOUR_KEY"

No key yet? Get a free trial key in one step (masked contacts, 30/min · 300/day · 2,000/month, 14 days). Production keys, the history add-on and enterprise plans are on the pricing page; every key — trial or paid — can see its own limits, quota, scope and usage on the dashboard.

Keys carry per-key rate limits (per-minute + per-day) and, on some tiers, a monthly quota. Every response carries RateLimit-Limit / RateLimit-Remaining / RateLimit-Reset headers (plus X-Quota-Limit / X-Quota-Used when a quota applies); 429s include Retry-After. Check your own usage anytime via GET /v1/usage. Demo and trial keys receive server-side-masked contact fields.

Keys can be scoped to specific states/countries and to a licensed set of columns — scoped keys are automatically narrowed to their grant, and out-of-scope requests return 403 scope_denied with the grant listed. See your key's scope at GET /v1/me. To request a production key, contact eli@compcurve.com.

Historical snapshots are a separate add-on. Every key reads the latest monthly snapshot; keys with history access (scope.history.mode = months or all on /v1/me) can pass ?snapshot=YYYY-MM to query prior months and call /v1/licenses/history to follow one license across months with a field-level change log. Outside your history scope the API returns 403 history_denied; /v1/snapshots flags each loaded month accessible true/false for your key.

{
  "data": [ { "id": 123, "state": "CA", "member_full_name": "…", … } ],
  "pagination": { "page": 1, "limit": 100, "total": 12345, "total_pages": 124,
                  "has_next": true, "has_prev": false },
  "meta": { "snapshot": "2026-07", "sort": ["state"], "order": "asc",
            "filters_applied": ["state"] }
}

Errors: { "error": { "code": "rate_limited", "message": "…" } } with an appropriate HTTP status — 400 invalid param · 401 unauthorized / key_suspended · 403 scope_denied / history_denied · 429 rate_limited / quota_exceeded / trial_limit · 5xx server.

Active brokers in Texas, newest first:

curl -s "https://api.compcurve.com/v1/licenses?state=TX&member_type=Broker&sort=member_license_issued&order=desc&limit=25" \
  -H "Authorization: Bearer $KEY"

Licenses expiring in the next 90 days (renewal outreach):

curl -s "https://api.compcurve.com/v1/licenses?state=FL&expires_after=2026-07-12&expires_before=2026-10-10&fields=id,member_full_name,office_name,member_license_expires,matched_email&limit=200" \
  -H "Authorization: Bearer $KEY"

Sparse fields for a dashboard (small payloads):

curl -s "https://api.compcurve.com/v1/licenses?state=CA,TX,FL&fields=id,state,member_full_name,member_state_license_number&limit=500" \
  -H "Authorization: Bearer $KEY"

Follow one license month over month (history add-on):

curl -s "https://api.compcurve.com/v1/licenses/history?state=TX&license_number=753285-SA&fields=member_full_name,office_name,member_license_status,member_license_expires" \
  -H "Authorization: Bearer $KEY"
# data.rows → one per snapshot, newest first · data.changes → field-level diffs between months