Search the verified clinical workforce, submit one-click discharge referrals, and resolve geography — programmatically. Get a self-serve sandbox key in seconds.
Paste an existing sandbox key, or request one — it's issued instantly to your inbox.
Base URL https://caraloom.com/api
/v1/healthpublicLiveness probe. No authentication required.
/v1/clinicians/search key requiredSearch the verified clinical workforce by state, city, ZIP, or diagnosis. Returns de-identified sandbox data.
Query: state, city, zip, diagnosis, limit
/v1/discharge-referrals key requiredSubmit a discharge referral and instantly receive matched, verified clinicians.
Body: { "primary_diagnosis": "CHF", "care_type": "Skilled Nursing", "zip": "78701" }
/v1/geo/zip/{zip} key requiredResolve a ZIP to its nearest service city + state.
/v1/webhooks key requiredRegister the endpoint that receives signed event callbacks. Returns a signing secret once.
Body: { "url": "https://your-app.com/hooks", "events": ["referral.created"] }
Example
curl "https://caraloom.com/api/v1/clinicians/search?state=TX&limit=3" \ -H "Authorization: Bearer clk_sandbox_YOUR_KEY"
For Epic, Cerner, and integration engines: every endpoint below returns a real FHIR R4 resource (proper resourceType, US-Core profile reference, Bundle searchset on search, and OperationOutcome on errors). The CapabilityStatement is public; reads/writes use the same sandbox API key as the native endpoints above.
/v1/fhir/metadatapublicFHIR R4 CapabilityStatement — read this to discover supported resources and search params.
/v1/fhir/Patient/{id} key requiredRead a Patient resource (US-Core profile reference).
Example: /v1/fhir/Patient/abc-123
/v1/fhir/Encounter/{id} key requiredRead an Encounter resource (HL7 v3 class=HH, home health visit).
/v1/fhir/Encounter key requiredSearch Encounters. Returns a Bundle (searchset).
Example: ?patient=abc-123&status=in-progress&_count=10
/v1/fhir/ServiceRequest/{id} key requiredRead a ServiceRequest representing a discharge referral.
/v1/fhir/ServiceRequest key requiredSearch ServiceRequests. Returns a Bundle (searchset).
Example: ?patient=abc-123&status=active&_count=10
/v1/fhir/ServiceRequest key requiredCreate a discharge referral via a real FHIR R4 ServiceRequest resource. Fires the referral.created webhook.
Fetch the CapabilityStatement
curl "https://caraloom.com/api/v1/fhir/metadata" \ -H "Accept: application/fhir+json"
Create a discharge referral (FHIR ServiceRequest)
curl -X POST "https://caraloom.com/api/v1/fhir/ServiceRequest" \
-H "Authorization: Bearer clk_sandbox_YOUR_KEY" \
-H "Content-Type: application/fhir+json" \
-d '{
"resourceType": "ServiceRequest",
"status": "active",
"intent": "order",
"subject": { "display": "Jane Doe, MRN-12345" },
"priority": "urgent",
"reasonCode": [{
"coding": [{
"system": "http://hl7.org/fhir/sid/icd-10-cm",
"code": "I50.9",
"display": "Heart failure"
}]
}],
"note": [{ "text": "Needs IV diuretic monitoring at home." }]
}'Runs against the live sandbox using the key above.
Register an endpoint to receive signed event callbacks (referral.created, referral.matched, ping). Every delivery is signed with HMAC-SHA256 over the raw body in the X-CaraLoom-Signature: sha256=… header — verify it with your signing secret.
Your webhook URL
Verify a signature (Python)
import hmac, hashlib
sig = hmac.new(SECRET.encode(), raw_body, hashlib.sha256).hexdigest()
assert request.headers["X-CaraLoom-Signature"] == f"sha256={sig}"Sandbox
Production
referral.created / referral.matched webhooksEvery response includes a rate object with your remaining quota. A 429 with Retry-After is returned when a window is exhausted.
A machine-readable OpenAPI 3.0 spec — import it into Postman, generate a client, or explore it interactively below.
v1
OAS 3.0
Search the verified clinical workforce, submit one-click discharge referrals, and resolve geography. Sandbox keys return de-identified demo data; production keys write real referrals into the live pipeline and emit signed webhooks. Authenticate with Authorization: Bearer <key> or X-API-Key.