# bluework API reference

Use this as compact context for the live bluework Jobs API.

Primary URLs:

- API base URL: https://api.bluework.dev
- OpenAPI JSON: https://api.bluework.dev/v1/openapi.json
- Docs: https://docs.bluework.dev/
- Landing page: https://bluework.dev/

Production shape:

- Version: 2026-05-29.greenhouse-ashby-lever-rippling-v0.
- Current sources include Greenhouse, Ashby, Lever, and Rippling public job boards.
- Current public counts are available at /v1/stats.
- Last baked-in snapshot: 123,584 job records, 86,101 active jobs, 37,483 inactive jobs retained, 11,446 orgs, 11,636 job boards, 4 ATS providers.
- Public job data includes active and inactive retained postings.
- Public event data includes job.created, job.updated, job.closed, and job.reopened.

Important public routes:

- /health
- /openapi.json
- /v1/openapi.json
- /v1/stats
- /v1/jobs/search
- /v1/jobs/{job_id}
- /v1/jobs/{job_id}/events
- /v1/jobs/facets
- /v1/orgs/search
- /v1/orgs/lookup
- /v1/orgs/batch_lookup
- /v1/orgs/{org_id}
- /v1/orgs/{org_id}/sources
- /v1/orgs/{org_id}/jobs
- /v1/orgs/{org_id}/events
- /v1/sources/search
- /v1/sources/{source_id}
- /v1/sources/{source_id}/jobs
- /v1/sources/{source_id}/events
- /v1/events/search
- /v1/query

Example:

```bash
curl "https://api.bluework.dev/v1/jobs/search?limit=2&country=United%20States"
```