# Job Postings API reference

Use this as compact context for the live bluedoor Job Postings API.

Primary URLs:

- API base URL: https://api.bluedoor.sh/job-postings/v1
- OpenAPI JSON: https://api.bluedoor.sh/job-postings/openapi.json
- Docs: https://bluedoor.sh/apis/job-postings/docs
- Landing page: https://bluedoor.sh/apis/job-postings

Production shape:

- Version: 2026-05-29.multi-provider-v1.
- Public job data includes active and inactive retained postings.
- Public event data includes job.created, job.updated, job.closed, and job.reopened.
- Anonymous reads are allowed; verified API keys provide higher limits.

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.bluedoor.sh/job-postings/v1/jobs/search?limit=2&country=United%20States"
```