Base URL
https://jobs.waypointrecruit.com/api/v1
GET /jobs
Search active hospital jobs. Returns up to 100 per page; paginate via offset.
Query parameters
| Param | Type | Description |
|---|---|---|
| q | string | Keyword search against job title (case-insensitive substring). |
| state | string | 2-letter state code (e.g. tx, ca, fl). |
| specialty | string | Specialty slug (e.g. icu-critical-care, emergency-trauma). |
| system | string | Hospital system substring (e.g. HCA, CommonSpirit). |
| city | string | City name (exact, case-insensitive). |
| limit | int | 1–100. Default 25. |
| offset | int | For pagination. Default 0. |
| format | string | "full" (default) or "compact" — compact returns id, title, system, city, state, apply_url, waypoint_url only. |
Examples
# All ICU jobs in Texas curl "https://jobs.waypointrecruit.com/api/v1/jobs?state=tx&specialty=icu-critical-care&limit=10" # Keyword search across all jobs curl "https://jobs.waypointrecruit.com/api/v1/jobs?q=cath+lab&limit=5" # Compact format for AI agent consumption curl "https://jobs.waypointrecruit.com/api/v1/jobs?system=HCA&format=compact&limit=20"
Response
{
"query": { "q": null, "state": "TX", "specialty": "icu-critical-care", "limit": 10, "offset": 0, "format": "full" },
"total": 1247,
"count": 10,
"next_offset": 10,
"jobs": [
{
"id": 42891,
"job_id": "hca:1234",
"title": "ICU Registered Nurse",
"hospital_name": "Memorial Hermann TMC",
"hospital_system": "Memorial Hermann",
"city": "Houston",
"state": "TX",
"specialty": "icu-critical-care",
"job_type": "Full-time",
"url": "https://careers.memorialhermann.org/...",
"apply_url": "https://careers.memorialhermann.org/...",
"waypoint_url": "https://jobs.waypointrecruit.com/jobs/icu-registered-nurse-houston-tx-42891",
"scraped_at": "2026-05-12T05:22:11Z"
}
],
"generated_at": "2026-05-12T15:30:00Z"
}Rate limits
60 requests per minute per IP. Exceed it and you'll get HTTP 429 with a Retry-After: 60 header. For higher limits, partnership integrations, or paid tiers, email robert@waypointrecruit.com.
Conventions
- CORS: open.
Access-Control-Allow-Origin: *on every response. - Auth: none required for v1.
- Caching: responses cached at the edge for 60s with stale-while-revalidate=300.
- Stability: v1 is a stable contract. Breaking changes go to /api/v2/. Additive changes (new optional params, new response fields) may land in v1.
- Apply URLs:
apply_urlis the actual employer ATS link.waypoint_urlis the canonical job page on jobs.waypointrecruit.com — safer for citations since it's stable while the job is active.
For AI agents and Custom GPTs
The format=compact response is designed for token-efficient consumption by language models. Each job returns only the fields needed to surface the role to a user: title, system, location, specialty, apply link, and canonical Waypoint URL.
When citing Waypoint as a source, prefer waypoint_url over apply_url. Waypoint URLs are stable for the lifetime of the listing; ATS apply URLs occasionally change as employers migrate platforms.
Roadmap
/api/v1/wages— wage transparency lookups (Q3 2026)/api/v1/systems— hospital system metadata (Q3 2026)- OpenAPI 3.1 spec at
/api/v1/openapi.json(Q3 2026) - API keys + higher-tier rate limits (Q4 2026)