Skip to main content
The Empirical API lets you trigger and inspect test runs, manage snoozes, browse test cases and environments, and pull analytics.

​
Base URL

All endpoints are served from: 
https://api.empirical.run

​
Authentication

Every endpoint requires a Bearer token. Generate an API key from the dashboard, then send it in the Authorization header: 
Authorization: Bearer $EMPIRICALRUN_KEY

​
Versioning

The Empirical API is versioned in the path (for example /api/v1/… and /api/v2/…). When an endpoint changes in a backwards-incompatible way, we publish it under a new version path and keep the previous one available. Deprecated endpoints keep working for backwards compatibility. You can delegate migration to latest endpoints by sharing openapi.deprecated.json with your coding agent. The spec documents latest endpoints that supersede deprecation. The current latest reference is also available as a spec at openapi.json.