Core asset · Foundation428 roles · 175K aliases

Taxonomy Mapper.

"Med-Surg RN", "MS Registered Nurse", "RN — Medical Surgical" — three records, one canonical role. Your messy data, reconciled before it enters a distribution.

428Canonical roles
175,231Aliases mapped
≥ 0.92Confidence floor
Inline · API · BulkResolution
Anatomy

What the mapper resolves, top to bottom.

01Raw title in

Whatever your ATS, CRM, or VMS calls it — including punctuation, abbreviations, and contract-length suffixes.

02Canonical role out

One of 428 entries. Every chart, alert, and API response across the platform speaks this language.

03Confidence score

0.00 — 1.00. The platform refuses to resolve below 0.92 and surfaces the ambiguity for human review.

04Override path

Teams can pin overrides for proprietary titles. Pinned mappings flow back into every downstream surface.

By the numbers

The reconciliation layer behind the platform.

428Canonical rolesTravel, per diem, local contract — separate cohorts.
175KAliases mappedCurated from production ATS / VMS / contract data.
0.92Confidence floorRecords below threshold route to human review, never silently bucketed.
100KBulk normalize / callEnterprise endpoint capacity, single batch.
Capability matrix

What Taxonomy Mapper ships with.

CapabilityDesk · Agency · Agency PlusEnterprise
Canonical taxonomy accessRead · suggestRead · suggest · override
Bulk normalize endpoint100K rows / call
Override pinningPer-userOrg-wide · audited
Confidence reportingPer-rowPer-row · per-source
Custom taxonomy extensionsPer-tenant namespace
Endpoint

One call. One canonical answer.

$ curl "https://api.clinicalrate.com/v1/normalize" -H "Authorization: Bearer $CR_TOKEN" \
--data '{"title": "MS RN — Travel 13wk"}'
# 200 OK
{
"input": "MS RN — Travel 13wk",
"role_id": "CR-0142",
"canonical": "Travel RN — Med/Surg",
"confidence": 0.98,
"contract_class": "travel-13wk",
"alternates": [
{ "role_id": "CR-0148", "canonical": "Travel RN — Telemetry", "confidence": 0.04 }
]
}
Under the hood

How an alias becomes canonical.

LexicalAbbreviation expansion + token stemming

"MS", "M/S", "Med-Surg", "MedSurg" — all normalized to a common form before retrieval. Built on a curated clinical abbreviation set, not generic NLP.

SemanticEmbedding retrieval across 175K aliases

Top-k similarity over the canonical alias corpus. The embedding model is fine-tuned on clinical role data — generic LLMs confuse "RT" (Respiratory Therapist) with "Radiology Tech".

DisambiguationContract-class + specialty splitter

"Travel" vs "per diem" vs "local contract" extracted as a separate dimension. ICU vs Med/Surg vs L&D never share a distribution by accident.

AuditEvery override is logged

When an operator pins an override, the change is timestamped, attributed, and reversible. The audit log is exportable to your compliance stack on Enterprise.

Enterprise tier · bulk normalize endpoint
PS
Priya ShahHead of Data · Hospital system, 14 facilities
We deleted three pages of regex from our ETL the week we plugged this in. Specialty distributions stopped being a debate and started being a benchmark.
What's included

Taxonomy Mapper by tier.

FAQ

Questions buyers ask about Taxonomy Mapper.

Anything below the 0.92 confidence floor is routed to a human-review queue with the top three candidate canonicals and their scores. Reviewed mappings are added to the alias corpus on the next nightly rebuild.

Yes. Every plan supports per-user pinned overrides; Enterprise adds org-wide, audited overrides. Pinned mappings flow through every downstream surface (Rate Explorer, Alert Stream, exports) without altering the global canonical taxonomy.

The canonical taxonomy is versioned. New roles enter through a quarterly review process; we publish a changelog and a migration note for any non-additive change. Pinned overrides are unaffected.

A clinical-domain embedding model handles the semantic step, but lexical expansion, contract-class extraction, and the override layer are deterministic. Confidence scores are calibrated on a held-out clinical corpus, not a generic benchmark.

Get started

Reconcile your data to one taxonomy.

Book a demo and bring a sample of your messiest role titles. We'll run them through live.