$2,500/MOEverything included · cancel anytime →
Developer · GAOpenAPI 3.1 · OAuth 2.0

API & Integrations.

REST, webhook, and warehouse share — three integration paths, one canonical taxonomy. Live in production inside three business days, measured across 22 partners.

OpenAPI 3.1
Spec
88ms p50 · 140ms p95
Median latency
99.9%
Uptime SLA
Py · TS · Go · Java
SDKs
◣ By the numbers

Production-grade integration surface.

88ms
p50 read latency
140 ms p95. Inline in placement-creation flows.
22
Live partner integrations
ATS, VMS, MSP platforms, and warehouses.
99.9%
Uptime SLA
Multi-region active-active.
3
Business days to production
Median across 22 partners. Sandbox key day one.
◣ Endpoint surface

Six endpoints. That's the whole API.

EndpointPurposeAccess
GET /v1/rates/{role}/{geo}Live percentile distribution for a canonical role × geography.Included
GET /v1/rates/bulkBatch lookup of up to 100 role × geo pairs in a single call.Included
POST /v1/normalizeResolve 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/subscriptionsCreate, update, or delete alert subscriptions with thresholds.Included
POST /v1/webhooks/replayReplay any event in the configured retention window.Included
◣ Integration paths

Three shapes. Pick by your latency budget.

A · Sync REST

Inline lookups

88ms median. Drop into a placement-creation flow or rate-card validator. OAuth 2.0 client-credentials, scoped tokens per environment.
B · Webhook

Push event stream

HMAC-signed, idempotency-keyed, at-least-once delivery. Replay window up to 5 years. Fan-out to your bus from one endpoint.
C · Warehouse

Bulk share

Snowflake Secure Data Share, Databricks Delta Share, or BigQuery transfer. Daily refresh at 03:00 UTC. Joinable to your own workforce data without exporting either side.
+ Sandbox

Frozen 90-day fixture

Every account includes a sandbox environment with 90 days of frozen historical rates — predictable test fixtures for CI without burning production rate-limit quota.
◣ Sample request

A bulk read in nine lines of curl.

OAuth 2.0 client credentials. Bulk endpoint hands you up to 100 role × geo pairs in a single response — joinable on canonical role ID.

api.clinicalrate.com
200 OK
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 ] }'
8
9# 200 OK · 92ms · X-CR-As-Of: 2026-05-11T03:00Z
10{
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.

◣ Bullhorn integration
“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.”
MW
Marcus Williams
Staff Engineer · National staffing platform
◣ What's included

API access is included.

ClinicalRate · One plan
$2,500/ month · cancel anytime

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.

◣ What’s in the box
  • OpenAPI 3.1 spec · OAuth 2.0 client credentials
  • Read API · /rates · /rates/bulk · /trends
  • POST /normalize · POST /subscriptions
  • Sandbox environment with 90-day frozen fixture
  • Python · TypeScript · Go · Java SDKs
  • Signed webhooks (GA)
  • Snowflake · Databricks · BigQuery secure data share
  • 99.9% uptime SLA
◣ FAQ

Questions engineers ask before they integrate.

How do you handle rate limits?+
Default is 10 req/sec per token, burst to 50, with monthly quotas. Sandbox tokens have separate quota so CI runs never affect production. We surface remaining quota on every response in X-RateLimit-* headers.
Versioning policy?+
URL-versioned (v1). Backwards-compatible changes ship without notice. Breaking changes require a six-month deprecation window and a written migration note. We have not retired a v1 endpoint since GA.
Can we fan out webhooks to multiple endpoints?+
Yes. Configure per-subscription endpoints in the dashboard or via POST /v1/subscriptions. Each endpoint gets its own signing key and replay history.
Auth?+
OAuth 2.0 client credentials with scoped tokens per environment (sandbox / production) and per integration partner. SCIM 2.0 for user provisioning.
Talk to ClinicalRate
◣ API & Integrations walkthrough

Get a sandbox key today.

Book a 30-minute scoping call. You'll leave with a sandbox token and an integration brief tailored to your stack.

◣ What we’ll cover
  • API & Integrations on your specialties and MSAs
  • Your real bids, pay packages, and margins
  • Embed path into your VMS, ATS, or BI stack
  • $2,500 / month, every feature included, cancel anytime

Routed directly to aaron@clinicalrate.com — no SDR queue.

Inbound · live
Avg. response · 1 business day

Or email aaron@clinicalrate.com