changedInput schema / properties / code_type / description
Previous value: -"Code system to list codes for, e.g. \"CPT\". From list_code_types."New value: +"Code system to list codes for, e.g. \"CPT\". From list_code_types. May be left empty when query is set, to search across code types (excluding hospital-specific CDM and LOCAL codes) - CodeSummary.code_type tells the hits apart in that case."
addedInput schema / properties / hospital_id
Added value: +{
+ "description": "Optional hospital scoping (a hospital_id from list_hospitals): restricts results to codes that hospital actually reports on its latest revision, and makes sample_count_min/max/exact that hospital's own sample size for the code rather than the network-wide total. Unset (default) is network-wide. page_token is only valid with the same hospital_id it was issued for, same as query/code_type/sort.",
+ "type": "string"
+}
changedInput schema / properties / page_token / description
Previous value: -"Opaque token from a previous list_codes response. Omit for the first page."New value: +"Opaque token from a previous list_codes response. Omit for the first page. Only valid with the same query/code_type/sort it was issued for."
addedInput schema / properties / query
Added value: +{
+ "description": "Case-insensitive text search: matches the code as a prefix, and substrings of the raw and friendly descriptions. Descriptions are only searched for queries of 4+ characters; shorter queries match the code prefix only. When set, code_type may be left empty to search across code types.",
+ "type": "string"
+}
changedInput schema / properties / sort / description
Previous value: -"Ordering for the returned codes. CODE_SORT_UNSPECIFIED (default) sorts code-alphabetical. CODE_SORT_HOSPITAL_COUNT_DESC sorts most-hospitals-reporting first, for pre-sorted 'top codes' pages. CODE_SORT_SAMPLE_COUNT_DESC sorts by largest pricing sample size first (total_sample_count_max) - ranks by how many billing records actually back a code's pricing, rather than by how many hospitals merely report it. CODE_SORT_CODE_DESC is code-alphabetical, reverse order."New value: +"Ordering for the returned codes. CODE_SORT_UNSPECIFIED (default) sorts code-alphabetical. CODE_SORT_HOSPITAL_COUNT_DESC sorts most-hospitals-reporting first, for pre-sorted 'top codes' pages. CODE_SORT_SAMPLE_COUNT_DESC sorts by largest network-wide pricing sample size first (sample_count_max, always network-wide regardless of hospital_id) - ranks by how many billing records actually back a code's pricing, rather than by how many hospitals merely report it. CODE_SORT_CODE_DESC is code-alphabetical, reverse order. CODE_SORT_RELEVANCE ranks best text match first (exact code, then code prefix, then description word-start, then description substring), ties broken by network-wide sample count descending, and is only meaningful - and the default - when query is set; without a query it behaves like CODE_SORT_SAMPLE_COUNT_DESC."
changedInput schema / properties / sort / enum
Previous value: -[
- "CODE_SORT_UNSPECIFIED",
- "CODE_SORT_HOSPITAL_COUNT_DESC",
- "CODE_SORT_SAMPLE_COUNT_DESC",
- "CODE_SORT_CODE_DESC"
-]New value: +[
+ "CODE_SORT_UNSPECIFIED",
+ "CODE_SORT_HOSPITAL_COUNT_DESC",
+ "CODE_SORT_SAMPLE_COUNT_DESC",
+ "CODE_SORT_CODE_DESC",
+ "CODE_SORT_RELEVANCE"
+]
changedInput schema / required
Previous value: -[
- "code_type"
-]New value: +[]
addedOutput schema / properties / codes / items / properties / code_type
Added value: +{
+ "description": "This code's type, e.g. \"CPT\". Always set - distinguishes hits when query was searched across code types (code_type left empty in the request).",
+ "type": "string"
+}
addedOutput schema / properties / codes / items / properties / friendly_description
Added value: +{
+ "description": "LLM-normalized, human-readable description. Empty when not yet backfilled - fall back to raw_description.",
+ "type": "string"
+}
addedOutput schema / properties / codes / items / properties / sample_count_exact
Added value: +{
+ "description": "True iff sample_count_min == sample_count_max, i.e. no contributing row was a de-identified '1 through 10' range.",
+ "type": "boolean"
+}
addedOutput schema / properties / codes / items / properties / sample_count_max
Added value: +{
+ "description": "Upper bound on the CMS sample-remittance count, same network-wide-vs-hospital-scoped convention as sample_count_min. Equal to sample_count_min unless a de-identified '1 through 10' row narrowed it to a range.",
+ "type": "integer"
+}
addedOutput schema / properties / codes / items / properties / sample_count_min
Added value: +{
+ "description": "Lower bound on the CMS sample-remittance count. By default (no hospital_id in the request) this sums every reporting hospital's contributing payer rows, network-wide; when the request scopes to a hospital_id, it's that one hospital's own sample count for this code instead. Equal to sample_count_max unless a de-identified '1 through 10' row narrowed it to a range.",
+ "type": "integer"
+}
removedOutput schema / properties / codes / items / properties / total_sample_count_exact
Removed value: -{
- "description": "True iff total_sample_count_min == total_sample_count_max, i.e. no contributing hospital's sample_count was a de-identified '1 through 10' range.",
- "type": "boolean"
-}
removedOutput schema / properties / codes / items / properties / total_sample_count_max
Removed value: -{
- "description": "Upper bound on the summed CMS sample-remittance count across every reporting hospital's contributing payer rows. Equal to total_sample_count_min unless a de-identified '1 through 10' row narrowed it to a range.",
- "type": "integer"
-}
removedOutput schema / properties / codes / items / properties / total_sample_count_min
Removed value: -{
- "description": "Lower bound on the summed CMS sample-remittance count across every reporting hospital's contributing payer rows. Equal to total_sample_count_max unless a de-identified '1 through 10' row narrowed it to a range.",
- "type": "integer"
-}