REST, webhook, and warehouse share — three integration paths, one canonical taxonomy. Live in production inside three business days, measured across 22 partners.
| Endpoint | Purpose | Access | |
|---|---|---|---|
| GET /v1/rates/{role}/{geo} | Live percentile distribution for a canonical role × geography. | Included | |
| GET /v1/rates/bulk | Batch lookup of up to 100 role × geo pairs in a single call. | Included | |
| POST /v1/normalize | Resolve any raw title to a canonical role with confidence. | Included | |
| GET /v1/trends/{role}/{geo} | 30-day, 90-day, or 1-year trend series for a role × geography. | Included | |
| POST /v1/subscriptions | Create, update, or delete alert subscriptions with thresholds. | Included | |
| POST /v1/webhooks/replay | Replay any event in the configured retention window. | Included |
OAuth 2.0 client credentials. Bulk endpoint hands you up to 100 role × geo pairs in a single response — joinable on canonical role ID.
1$ curl "https://api.clinicalrate.com/v1/rates/bulk" \2 -H "Authorization: Bearer $CR_TOKEN" \3 -H "Content-Type: application/json" \4 --data '{ "pairs": [5 {"role_id": "CR-0142", "state": "CA"},6 {"role_id": "CR-0207", "state": "TX"}7 ] }'89# 200 OK · 92ms · X-CR-As-Of: 2026-05-11T03:00Z10{11 "results": [12 { "role_id": "CR-0142", "state": "CA", "p50": 92.00, "sample_size": 2418 },13 { "role_id": "CR-0207", "state": "TX", "p50": 218.40, "sample_size": 312 }14 ]15}
Same envelope across REST, webhook, and warehouse share — every record carries role_id, sample_size, and as_of.
Inline rate suggestions on the placement record.
Integration brief →VMSRate-card validation and re-pricing flows.
Integration brief →WarehouseDaily Secure Data Share, joinable to your workforce data.
Integration brief →“We were live in three days. The bulk endpoint cut a four-step ETL down to one call, and the webhook replaced two cron jobs we used to babysit on Mondays.”
REST lookups inside Bullhorn, Avionté, JobDiva — the rate suggestion is on the placement record, not in another tab.
Snowflake / Databricks / BigQuery secure data share. Joinable to your own workforce data without exporting either side.
OAuth 2.0 client credentials, scoped tokens per environment, sandbox with frozen 90-day fixtures for CI.
The full API surface — REST, webhooks, warehouse share, and SDKs — is included in the single ClinicalRate plan, with no seat licenses and SSO built in. Embedding or white-label needs? Talk to us.
Quote to the 50th. Defend at the 75th.
Read more →FeatureMargin events. Not weekly digests.
Read more →GuideWhat a hospital vendor management system does across the order lifecycle, its core modules, vendor-neutral vs MSP-owned VMS, who pays, integrations, and how agencies work inside one.
Read more →Book a 30-minute scoping call. You'll leave with a sandbox token and an integration brief tailored to your stack.
Routed directly to aaron@clinicalrate.com — no SDR queue.