API
Public API
Only currently published endpoints are documented here. Mock or withheld data surfaces are intentionally excluded until their backing datasets are audit-ready.
Endpoint surface
| Method | Path | Description | Auth |
|---|---|---|---|
| GET | /api/v1/layoffs | Official-source layoff feed with current monitored disclosures and source-health metadata. | Public |
| GET | /api/v1/layoffs/health | Source-health view for the monitored layoff feed. | Public |
| GET | /api/v1/occupations/search | Autocomplete search across the published occupation brief dataset. | Public |
| GET | /api/v1/risk/:soc | Source-backed occupation brief for a valid SOC code. | Public |
| POST | /api/v1/subscribers | Newsletter signup with pending confirmation status. | Public |
Auth model
Anonymous requests stay rate limited and read-only. Additional newsroom or research access can be layered in later once those datasets are live and audited.
Current state
The documented surface is deliberately small. Occupation search, the sourced occupation brief, the official-source layoff feed, and subscriber signup are live. Jobs, companies, and trends remain undocumented until those APIs are published with the same audit trail.