Loading documentation

Access required

Your account doesn't have access to the documentation. Contact your administrator.

Sign out
Skip to main content

Fee Schedule Tree

Status: stable Category: lookup Added: 2026-10-14 Last 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 its coverage (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 as locality in 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​

FieldValue
MethodGET
Path/api/lookup/fee_schedule/tree
Full URLhttps://engine.tripod-health.com/api/lookup/fee_schedule/tree
AuthenticationAPI key (required)
Request bodynone
Response bodyapplication/json
IdempotentYes
Rate-limitedYes

Authentication​

Send a valid API key in the apikey header. See authentication.md.

Request​

Headers​

HeaderRequiredDescription
apikeyYesConsumer 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​

ParameterTypeRequiredDefaultDescription
nodestringNo—A jurisdiction (CA, medicare; case-insensitive) or a locality key (CA:18, PA:001). Omit it to list every jurisdiction.
as_ofstringNotoday (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​

FieldTypeAlways presentDescription
nodeobject | nullYesThe requested jurisdiction or locality. null when node was omitted.
ancestorsarrayYesEmpty for a jurisdiction. For a locality, one entry: the jurisdiction node it sits under.
versionsarrayYesFor a jurisdiction node, its full fee schedule version history, newest first. Empty for the top level and for a locality.
versions[].labelstringYesThe version's label, as returned in version.label by get.
versions[].effective_fromstringYesFirst date of service the version applies to, YYYY-MM-DD.
versions[].effective_tostring | nullYesLast 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[].methodstringYesmedicare_rbrvs, state_cf_rbrvs, state_table, or no_fee_schedule.
versions[].medicare_releasestring | nullYesThe 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[].citationstringYesThe legal citation for the version.
as_ofstringYesThe date the coverage and children reflect, YYYY-MM-DD.
childrenarrayYesJurisdictions at the top level; localities or regions under a covered jurisdiction; empty otherwise.
children[].code / node.codestringYesA jurisdiction code (CA, medicare) or a locality key (CA:18). Pass a jurisdiction as jurisdiction, a locality key as locality.
children[].label / node.labelstringYesThe jurisdiction, locality, or region name.
children[].kind / node.kindstringYesjurisdiction, locality, or region.
children[].coverage / node.coveragestringJurisdictions onlycovered, no_fee_schedule, or not_covered_by_engine on as_of.
children[].method / node.methodstring | nullJurisdictions onlyThe method of the version in force on as_of; null when none.
children[].has_children / node.has_childrenbooleanYestrue for a covered jurisdiction, whose node lists localities.
request_idstringYesCorrelation ID. Quote in support tickets.
timestampstring (ISO 8601 UTC)YesServer time when the response was emitted.

Status codes​

CodeMeaningWhen
200OKLevel returned.
400ValidationErroras_of is not a calendar date, or a parameter was repeated. field names the offender.
401UnauthenticatedMissing or invalid API key.
404NotFoundnode names no recognized jurisdiction, or a locality key that is not in force on as_of.
429RateLimitedPer-consumer rate limit exceeded.
500InternalErrorUnexpected 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 coverage instead of calling get and interpreting not_covered_by_engine.
  • Showing which rules applied on a date — versions gives 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 label as locality. Pass its code (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​

  1. Capture request_id from the response body (or, if the response has no body from the engine, the X-Request-ID response header).
  2. 404 NotFound for a jurisdiction. Use a USPS state code, DC, medicare or owcp.
  3. 404 NotFound for a locality key. The key is not in force on as_of. List the jurisdiction's current keys with ?node=<state>, or ?node=medicare for every state's Medicare localities.
  4. children empty for a jurisdiction. It is not covered, or has no fee schedule, on as_of; check coverage.

Rate limits​

See rate-limits.md for the current per-consumer limits.

Change history​

DateChange
2026-10-14Initial publication.
2026-10-14The 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.