API Reference
REST API with 52 endpoints across compensation, financial, CalPERS, taxonomy, and market data. All responses follow RFC 7807 error format with consistent pagination.
https://api.calcompdata.com/v1X-API-Key header/positionsList positions with filters — agency, year, taxonomy, department, title search, pay ranges
/positions/aggregateGrouped statistics — average pay by agency, taxonomy code, year, or department
/positions/yoyYear-over-year compensation trends for a position across agencies
/positions/percentilesP25/P50/P75/P90 percentile analysis across peer agencies
/positions/current-compStaleness-bridged current compensation estimates with COLA adjustment
/positions/direct-labor-rateDirect labor cost rate — salary + benefits as an hourly rate
/positions/compactionSalary compaction analysis between classification levels
/agenciesSearch and list agencies — filter by county, category, size tier
/agencies/{id}Agency detail with data availability summary
/agencies/{id}/data-qualityData quality assessment — completeness, classification coverage
/agencies/{id}/similarFind similar agencies by composite scoring (size, geography, category)
/calpersCalPERS employer contribution rates — filter by agency, year, category, tier
/calpers/historyRate history over time with year-over-year changes
/financialFinancial actuals — revenue and expenditure data by agency and fiscal year
/taxonomyList platform taxonomy entries — filter by family, search by title
/taxonomy/{code}/crosswalkSOC crosswalk with BLS market benchmark data for a taxonomy code
/classifyClassify up to 100 position titles to taxonomy codes (AI-powered)
/classify/feedbackSubmit classification correction to improve future accuracy
/taxonomy/frameworksList your taxonomy frameworks
/taxonomy/frameworksRegister a new taxonomy framework with entries
/taxonomy/frameworks/{name}Get framework entries and crosswalk mappings
/taxonomy/frameworks/{name}/crosswalkMap your codes to platform taxonomy codes
/taxonomy/frameworks/{name}Delete framework and all crosswalk mappings
/market/{agencyId}Market metrics — housing, crime, employment, migration for agency location
/market/{agencyId}/cola-indexCOLA context index — CPI, housing costs, and wage data
/market/{agencyId}/development-activityGrowth activity — housing, population, migration, commuters
/market/{agencyId}/tax-baseRevenue composition from FTR data
/export/positionsSynchronous position export (< 50K rows) — CSV or XLSX
/export/positionsAsync export for large datasets — returns job ID
/export/{jobId}Poll async export job status and download URL
/export/financialExport financial data
/export/calpersExport CalPERS data
/export/templatesList available export templates (5 built-in consulting templates)
/export/templatesCreate custom export template with column selection
/errorsSubmit data error report with expected value
/errorsList your error reports with SLA status
/annotationsAnnotate records with flags, overrides, or notes
/webhooksSubscribe to data update webhooks (HMAC-signed)
/meta/data-currencyData freshness and SLA compliance status
/meta/changelogData corrections changelog (embargo-aware)
/workspacesList subscriber workspaces
/workspacesCreate a workspace with saved queries and preferences
/workspaces/{id}Get workspace details
/workspaces/{id}Update workspace name or config
/workspaces/{id}Delete workspace
/healthService health check — status, version, uptime
/openapi.jsonOpenAPI 3.1 specification (public, no auth)
/docsData dictionary and capabilities reference
/geography/{agencyId}City profile for agency — census data, housing, demographics
/geography/countiesList California counties with FIPS codes and regions
/pension/formulasPension formula lookup with PEPRA/Classic tier identification
/pension/capsAnnual PEPRA pensionable compensation caps
Interactive API playground available at openapi.json. Import into Postman, Insomnia, or any OpenAPI-compatible client to explore endpoints with live requests.