Fee Schedule Tree
Status:
stableCategory:lookupAdded:2026-10-14Last reviewed:2026-10-14
Summary
Lists what the workers' compensation fee schedule lookup covers, so valid parameter values are read rather than guessed. Three levels:
- No
node— every jurisdiction the engine recognizes, with itscoverage(covered,no_fee_schedule,not_covered_by_engine). node=CA— one jurisdiction, its fee schedule version history with citations, and the localities or regions valid aslocalityin get and search.node=CA:18— one locality or region.
Today the covered jurisdictions are medicare, CA, TX and PA.
IN, IA, MO, NH, NJ and WI publish no professional fee
schedule. Every other state, DC and owcp are recognized and not
covered. Each covered jurisdiction's newest version is in force
through its effective_to (2026-12-31 today); a later as_of
reports it not_covered_by_engine until the next period's version is
published. This endpoint is the live answer; read it rather than
hard-coding the list.
Endpoint
| Field | Value |
|---|---|
| Method | GET |
| Path | /api/lookup/fee_schedule/tree |
| Full URL | https://engine.tripod-health.com/api/lookup/fee_schedule/tree |
| Authentication | API key (required) |
| Request body | none |
| Response body | application/json |
| Idempotent | Yes |
| Rate-limited | Yes |
Authentication
Send a valid API key in the apikey header. See
authentication.md.
Request
Headers
| Header | Required | Description |
|---|---|---|
apikey | Yes | Consumer API key. |
The engine assigns its own request id to every request and returns it
in the response body's request_id. An X-Request-ID sent by the caller
is ignored. The X-Request-ID response header is the gateway's trace ID
for the same request and does not match request_id.
Path parameters
None.
Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
node | string | No | — | A jurisdiction (CA, medicare; case-insensitive) or a locality key (CA:18, PA:001). Omit it to list every jurisdiction. |
as_of | string | No | today (UTC) | The date whose coverage and localities to return, YYYY-MM-DD. Version history is returned in full regardless. |
Body
None.
Response
Success — 200 OK
Request: GET /api/lookup/fee_schedule/tree?node=CA
{
"node": {
"code": "CA",
"label": "California",
"kind": "jurisdiction",
"coverage": "covered",
"method": "state_cf_rbrvs",
"has_children": true
},
"ancestors": [],
"versions": [
{ "label": "CA 2026-10-01", "effective_from": "2026-10-01", "effective_to": "2026-12-31", "method": "state_cf_rbrvs", "medicare_release": "2026D", "citation": "8 CCR 9789.12.2, 9789.19(m); DWC Administrative Director Order of 9/29/2026, services on or after 10/1/2026, adopting RVU26D" },
{ "label": "CA 2026-07-01", "effective_from": "2026-07-01", "effective_to": "2026-09-30", "method": "state_cf_rbrvs", "medicare_release": "2026C", "citation": "8 CCR 9789.12.2, 9789.19(m); DWC Administrative Director Order of 7/7/2026 (superseding 6/16/2026), services on or after 7/1/2026, adopting the corrected RVU26C" },
{ "label": "CA 2026-04-01", "effective_from": "2026-04-01", "effective_to": "2026-06-30", "method": "state_cf_rbrvs", "medicare_release": "2026B", "citation": "8 CCR 9789.12.2, 9789.19(m); DWC Administrative Director Order of 3/16/2026, services on or after 4/1/2026, adopting RVU26B" },
{ "label": "CA 2026-03-01", "effective_from": "2026-03-01", "effective_to": "2026-03-31", "method": "state_cf_rbrvs", "medicare_release": "2026A", "citation": "8 CCR 9789.12.2, 9789.19(m); DWC Administrative Director Order of 1/28/2026 (as amended 2/20/2026), services on or after 3/1/2026, adopting RVU26A" }
],
"as_of": "2026-10-14",
"children": [
{ "code": "CA:54", "label": "BAKERSFIELD", "kind": "locality", "has_children": false },
{ "code": "CA:55", "label": "CHICO", "kind": "locality", "has_children": false },
{ "code": "CA:71", "label": "EL CENTRO", "kind": "locality", "has_children": false },
{ "code": "CA:56", "label": "FRESNO", "kind": "locality", "has_children": false },
{ "code": "CA:57", "label": "HANFORD-CORCORAN", "kind": "locality", "has_children": false },
{ "code": "CA:18", "label": "LOS ANGELES-LONG BEACH-ANAHEIM (LOS ANGELES/ORANGE CNTY)", "kind": "locality", "has_children": false },
{ "code": "CA:58", "label": "MADERA", "kind": "locality", "has_children": false },
{ "code": "CA:59", "label": "MERCED", "kind": "locality", "has_children": false },
{ "code": "CA:60", "label": "MODESTO", "kind": "locality", "has_children": false },
{ "code": "CA:51", "label": "NAPA", "kind": "locality", "has_children": false },
{ "code": "CA:17", "label": "OXNARD-THOUSAND OAKS-VENTURA", "kind": "locality", "has_children": false },
{ "code": "CA:61", "label": "REDDING", "kind": "locality", "has_children": false },
{ "code": "CA:75", "label": "REST OF CALIFORNIA", "kind": "locality", "has_children": false },
{ "code": "CA:62", "label": "RIVERSIDE-SAN BERNARDINO-ONTARIO", "kind": "locality", "has_children": false },
{ "code": "CA:63", "label": "SACRAMENTO-ROSEVILLE-FOLSOM", "kind": "locality", "has_children": false },
{ "code": "CA:64", "label": "SALINAS", "kind": "locality", "has_children": false },
{ "code": "CA:72", "label": "SAN DIEGO-CHULA VISTA-CARLSBAD", "kind": "locality", "has_children": false },
{ "code": "CA:52", "label": "SAN FRANCISCO-OAKLAND-BERKELEY (MARIN CNTY)", "kind": "locality", "has_children": false },
{ "code": "CA:05", "label": "SAN FRANCISCO-OAKLAND-BERKELEY (SAN FRANCISCO/SAN MATEO/ALAMEDA/CONTRA COSTA CNTY)", "kind": "locality", "has_children": false },
{ "code": "CA:65", "label": "SAN JOSE-SUNNYVALE-SANTA CLARA (SAN BENITO CNTY)", "kind": "locality", "has_children": false },
{ "code": "CA:09", "label": "SAN JOSE-SUNNYVALE-SANTA CLARA (SANTA CLARA CNTY)", "kind": "locality", "has_children": false },
{ "code": "CA:73", "label": "SAN LUIS OBISPO-PASO ROBLES", "kind": "locality", "has_children": false },
{ "code": "CA:66", "label": "SANTA CRUZ-WATSONVILLE", "kind": "locality", "has_children": false },
{ "code": "CA:74", "label": "SANTA MARIA-SANTA BARBARA", "kind": "locality", "has_children": false },
{ "code": "CA:67", "label": "SANTA ROSA-PETALUMA", "kind": "locality", "has_children": false },
{ "code": "CA:68", "label": "STOCKTON", "kind": "locality", "has_children": false },
{ "code": "CA:53", "label": "VALLEJO", "kind": "locality", "has_children": false },
{ "code": "CA:69", "label": "VISALIA", "kind": "locality", "has_children": false },
{ "code": "CA:70", "label": "YUBA CITY", "kind": "locality", "has_children": false }
],
"request_id": "14cce859-134f-4b99-806e-4cfb0a1cfd7d",
"timestamp": "2026-10-14T00:34:55.854Z"
}
A jurisdiction priced on Medicare geography (medicare, CA, TX)
lists Medicare localities with kind: "locality". A jurisdiction with
its own published table lists that table's regions with
kind: "region" — Pennsylvania's are PA:001 to PA:004. Either kind
is a valid locality value.
Response fields
| Field | Type | Always present | Description |
|---|---|---|---|
node | object | null | Yes | The requested jurisdiction or locality. null when node was omitted. |
ancestors | array | Yes | Empty for a jurisdiction. For a locality, one entry: the jurisdiction node it sits under. |
versions | array | Yes | For a jurisdiction node, its full fee schedule version history, newest first. Empty for the top level and for a locality. |
versions[].label | string | Yes | The version's label, as returned in version.label by get. |
versions[].effective_from | string | Yes | First date of service the version applies to, YYYY-MM-DD. |
versions[].effective_to | string | null | Yes | Last date of service it applies to, YYYY-MM-DD. For the newest version of a priced jurisdiction this is the last date the engine holds figures for: a later as_of answers not_covered_by_engine until the engine publishes the next period's version. null only for a jurisdiction with no fee schedule. |
versions[].method | string | Yes | medicare_rbrvs, state_cf_rbrvs, state_table, or no_fee_schedule. |
versions[].medicare_release | string | null | Yes | The CMS release whose relative values the version uses (2026D); in_effect when it uses whichever Medicare release is in effect on the date of service; null when it does not use Medicare relative values. |
versions[].citation | string | Yes | The legal citation for the version. |
as_of | string | Yes | The date the coverage and children reflect, YYYY-MM-DD. |
children | array | Yes | Jurisdictions at the top level; localities or regions under a covered jurisdiction; empty otherwise. |
children[].code / node.code | string | Yes | A jurisdiction code (CA, medicare) or a locality key (CA:18). Pass a jurisdiction as jurisdiction, a locality key as locality. |
children[].label / node.label | string | Yes | The jurisdiction, locality, or region name. |
children[].kind / node.kind | string | Yes | jurisdiction, locality, or region. |
children[].coverage / node.coverage | string | Jurisdictions only | covered, no_fee_schedule, or not_covered_by_engine on as_of. |
children[].method / node.method | string | null | Jurisdictions only | The method of the version in force on as_of; null when none. |
children[].has_children / node.has_children | boolean | Yes | true for a covered jurisdiction, whose node lists localities. |
request_id | string | Yes | Correlation ID. Quote in support tickets. |
timestamp | string (ISO 8601 UTC) | Yes | Server time when the response was emitted. |
Status codes
| Code | Meaning | When |
|---|---|---|
200 | OK | Level returned. |
400 | ValidationError | as_of is not a calendar date, or a parameter was repeated. field names the offender. |
401 | Unauthenticated | Missing or invalid API key. |
404 | NotFound | node names no recognized jurisdiction, or a locality key that is not in force on as_of. |
429 | RateLimited | Per-consumer rate limit exceeded. |
500 | InternalError | Unexpected failure. Quote request_id in the ticket. |
Examples
curl
curl -sS "https://engine.tripod-health.com/api/lookup/fee_schedule/tree?node=CA" \
-H "apikey: $ENGINE_API_KEY"
Every jurisdiction
Federal schedules first, then the states and DC alphabetically by name.
curl -sS "https://engine.tripod-health.com/api/lookup/fee_schedule/tree" \
-H "apikey: $ENGINE_API_KEY"
{
"node": null,
"ancestors": [],
"versions": [],
"as_of": "2026-10-14",
"children": [
{ "code": "medicare", "label": "Medicare Physician Fee Schedule", "kind": "jurisdiction", "coverage": "covered", "method": "medicare_rbrvs", "has_children": true },
{ "code": "owcp", "label": "DOL OWCP (federal employees' workers' compensation)", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "AL", "label": "Alabama", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "AK", "label": "Alaska", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "AZ", "label": "Arizona", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "AR", "label": "Arkansas", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "CA", "label": "California", "kind": "jurisdiction", "coverage": "covered", "method": "state_cf_rbrvs", "has_children": true },
{ "code": "CO", "label": "Colorado", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "CT", "label": "Connecticut", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "DE", "label": "Delaware", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "DC", "label": "District of Columbia", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "FL", "label": "Florida", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "GA", "label": "Georgia", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "HI", "label": "Hawaii", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "ID", "label": "Idaho", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "IL", "label": "Illinois", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "IN", "label": "Indiana", "kind": "jurisdiction", "coverage": "no_fee_schedule", "method": "no_fee_schedule", "has_children": false },
{ "code": "IA", "label": "Iowa", "kind": "jurisdiction", "coverage": "no_fee_schedule", "method": "no_fee_schedule", "has_children": false },
{ "code": "KS", "label": "Kansas", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "KY", "label": "Kentucky", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "LA", "label": "Louisiana", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "ME", "label": "Maine", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "MD", "label": "Maryland", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "MA", "label": "Massachusetts", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "MI", "label": "Michigan", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "MN", "label": "Minnesota", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "MS", "label": "Mississippi", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "MO", "label": "Missouri", "kind": "jurisdiction", "coverage": "no_fee_schedule", "method": "no_fee_schedule", "has_children": false },
{ "code": "MT", "label": "Montana", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "NE", "label": "Nebraska", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "NV", "label": "Nevada", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "NH", "label": "New Hampshire", "kind": "jurisdiction", "coverage": "no_fee_schedule", "method": "no_fee_schedule", "has_children": false },
{ "code": "NJ", "label": "New Jersey", "kind": "jurisdiction", "coverage": "no_fee_schedule", "method": "no_fee_schedule", "has_children": false },
{ "code": "NM", "label": "New Mexico", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "NY", "label": "New York", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "NC", "label": "North Carolina", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "ND", "label": "North Dakota", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "OH", "label": "Ohio", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "OK", "label": "Oklahoma", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "OR", "label": "Oregon", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "PA", "label": "Pennsylvania", "kind": "jurisdiction", "coverage": "covered", "method": "state_table", "has_children": true },
{ "code": "RI", "label": "Rhode Island", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "SC", "label": "South Carolina", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "SD", "label": "South Dakota", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "TN", "label": "Tennessee", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "TX", "label": "Texas", "kind": "jurisdiction", "coverage": "covered", "method": "state_cf_rbrvs", "has_children": true },
{ "code": "UT", "label": "Utah", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "VT", "label": "Vermont", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "VA", "label": "Virginia", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "WA", "label": "Washington", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "WV", "label": "West Virginia", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false },
{ "code": "WI", "label": "Wisconsin", "kind": "jurisdiction", "coverage": "no_fee_schedule", "method": "no_fee_schedule", "has_children": false },
{ "code": "WY", "label": "Wyoming", "kind": "jurisdiction", "coverage": "not_covered_by_engine", "method": null, "has_children": false }
],
"request_id": "e438b059-fd90-4c75-9bb2-af0e810e8cc9",
"timestamp": "2026-10-14T00:34:56.050Z"
}
One locality
curl -sS "https://engine.tripod-health.com/api/lookup/fee_schedule/tree?node=CA:18" \
-H "apikey: $ENGINE_API_KEY"
{
"node": {
"code": "CA:18",
"label": "LOS ANGELES-LONG BEACH-ANAHEIM (LOS ANGELES/ORANGE CNTY)",
"kind": "locality",
"has_children": false
},
"ancestors": [
{
"code": "CA",
"label": "California",
"kind": "jurisdiction",
"coverage": "covered",
"method": "state_cf_rbrvs",
"has_children": true
}
],
"versions": [],
"as_of": "2026-10-14",
"children": [],
"request_id": "da35e9bc-59ea-417a-bb03-ed92ddfd2b75",
"timestamp": "2026-10-14T00:34:56.422Z"
}
A locality key in a state the engine does not cover (for example
AL:00) resolves under medicare, whose children carry every state's
Medicare localities, so every key a tree response hands out resolves.
Python (requests)
# Uses the call() helper from quickstart.md.
top = call("GET", "/api/lookup/fee_schedule/tree")
covered = [j["code"] for j in top["children"] if j["coverage"] == "covered"]
print("covered:", covered)
ca = call("GET", "/api/lookup/fee_schedule/tree?node=CA")
current = ca["versions"][0]
print(current["label"], "-", current["citation"])
localities = {c["code"]: c["label"] for c in ca["children"]}
Node.js (native fetch)
// Uses the call() helper from quickstart.md.
const tx = await call("GET", "/api/lookup/fee_schedule/tree?node=TX");
const options = tx.children.map((c) => ({ value: c.code, label: c.label }));
console.log(`${tx.node.label}: ${options.length} localities, version ${tx.versions[0].label}`);
TypeScript
type Coverage = "covered" | "no_fee_schedule" | "not_covered_by_engine";
interface JurisdictionNode {
code: string;
label: string;
kind: "jurisdiction";
coverage: Coverage;
method: string | null;
has_children: boolean;
}
interface LocalityNode {
code: string;
label: string;
kind: "locality" | "region";
has_children: false;
}
interface FeeScheduleVersion {
label: string;
effective_from: string;
effective_to: string | null;
method: string;
medicare_release: string | null;
citation: string;
}
interface FeeScheduleTreeResponse {
node: JurisdictionNode | LocalityNode | null;
ancestors: JurisdictionNode[];
versions: FeeScheduleVersion[];
as_of: string;
children: (JurisdictionNode | LocalityNode)[];
request_id: string;
timestamp: string;
}
const ca = await call<FeeScheduleTreeResponse>("GET", "/api/lookup/fee_schedule/tree?node=CA");
Error scenarios
Unknown jurisdiction
Send:
curl -sS "https://engine.tripod-health.com/api/lookup/fee_schedule/tree?node=XX" \
-H "apikey: $ENGINE_API_KEY" \
-w "\nHTTP %{http_code}\n"
Receive (404):
{
"timestamp": "2026-10-14T00:34:56.601Z",
"error": "NotFound",
"message": "No fee schedule node 'XX'",
"request_id": "29295362-f01d-467b-bfb4-a0e41a898297"
}
Invalid as_of
Send:
curl -sS "https://engine.tripod-health.com/api/lookup/fee_schedule/tree?node=CA&as_of=2026-02-30" \
-H "apikey: $ENGINE_API_KEY" \
-w "\nHTTP %{http_code}\n"
Receive (400):
{
"timestamp": "2026-10-14T00:34:56.708Z",
"error": "ValidationError",
"message": "Query parameter 'as_of' must be a calendar date, YYYY-MM-DD",
"field": "as_of",
"request_id": "c93f49df-6816-46ae-88bd-ed037b2f091e"
}
Intended use
- Populating jurisdiction and locality pickers with values that get and search accept.
- Checking coverage before pricing — read
coverageinstead of calling get and interpretingnot_covered_by_engine. - Showing which rules applied on a date —
versionsgives every version's date range and citation, so a historical bill can be matched to the schedule in force when the service was performed.
Mistaken use
- Do not use tree to price anything. It returns coverage and keys,
never amounts. Use
/api/lookup/fee_schedule/get. - Do not hard-code the covered list or locality keys. Coverage grows and localities can change between releases; read them here.
- Do not pass a locality's
labelaslocality. Pass itscode(CA:18). - Do not expect localities under a state that is not covered. Its
node has no children; its Medicare localities are listed under
medicare(?node=medicare).
Debugging
- Capture
request_idfrom the response body (or, if the response has no body from the engine, theX-Request-IDresponse header). 404 NotFoundfor a jurisdiction. Use a USPS state code,DC,medicareorowcp.404 NotFoundfor a locality key. The key is not in force onas_of. List the jurisdiction's current keys with?node=<state>, or?node=medicarefor every state's Medicare localities.childrenempty for a jurisdiction. It is not covered, or has no fee schedule, onas_of; checkcoverage.
Rate limits
See rate-limits.md for the current per-consumer limits.
Related
- lookup-fee_schedule-get.md — the maximum for one service line.
- lookup-fee_schedule-search.md — a priced rate-sheet slice.
- lookup-icd10cm-tree.md, lookup-cpt-tree.md — the code-set trees.
- authentication.md, errors.md, rate-limits.md, conventions.md — cross-cutting contract rules.
Change history
| Date | Change |
|---|---|
| 2026-10-14 | Initial publication. |
| 2026-10-14 | The X-Request-ID response header is the gateway's trace ID for the request and does not match request_id; quote request_id to support. |