HL7 Terminology (THO)
6.0.2 - Publication International flag

This page is part of the HL7 Terminology (v6.0.2: Release) based on FHIR (HL7® FHIR® Standard) v5.0.0. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

Using CPT with HL7 Standards

This page describes how to use CPT with HL7 Standards.

Using CPT with FHIR R5

Summary

SourceCPT is made managed by the American Medical Association
SystemThe URI http://www.ama-assn.org/go/cpt identifies the CPT code system
VersionWhere a version is appropriate, use the year of release e.g. 2014
Code"Code" in the CPT tables (a 5-character code), a modifier code (2 characters), or an expression with modifiers (see below)
DisplayThe correct display for a CPT code is one of the descriptions associated with the code. There are multiple description options that vary by length and target audience, including: long descriptions, medium descriptions, short descriptions, consumer friendly descriptors and clinician descriptors. The long mixed-case description is the preferred general purpose display as the others are not fully descriptive. There is no defined display for CPT expressions
InactiveFor CPT Link ontology licensees, inactive codes are listed in the History folder in the “Deleted_DTK_pipe” and “Deleted_DTK_tab” files.
For CPT flat file licensees, codes that exist in the flat file are active and codes that are not present are inactive. Deletions/changes between the previous release year and current release year are displayed in the “Appendix B” PDF.
SubsumptionNo Subsumption relationships are defined by CPT
Filter PropertiesThere are several defined - see below

Version Issues

A new code-year of CPT is released by the end of August each year for use the subsequent calendar year. CPT versions are identified by the year of their intended use e.g. 2020. For example, the CPT 2020 codes are released at the end of August 2019 and intended for use during the 2020 calendar year.

Example Usage

  <coding>
    <system value="http://www.ama-assn.org/go/cpt"/>
    <version value="2023"/>
    <code value="31502"/>
    <display value="Tracheotomy tube change prior to establishment of fistula tract"/>
  </coding>

Copyright/License Issues

CPT is a registered trademark of the American Medical Association. The AMA holds the copyright for the CPT coding system and a license is required for use.

When Value Sets include CPT codes, the ValueSet.compose.include.copyright element should have the text "CPT © Copyright 2023 American Medical Association. All rights reserved. AMA and CPT are registered trademarks of the American Medical Association.". The year in the copyright element should be adjusted to reflect the release year(s) being used.

Note that due to the copyright and licensing rules around CPT, HL7 does not distribute a pre-built CodeSystem for CPT. If implementers would find a CPT code system useful, they may build one using the HL7 Java validator. See HL7 Confluence for details.

With regard to version, the copyright phrase above SHOULD be included in the ValueSet.copyright statement for any value set that includes CPT codes.

Modifier Syntax

CPT defines a series of 2 letter modifier codes that provide additional information about the main CPT code. Some contexts of use of CPT codes separate the base code and the modifier codes into separate fields (e.g. claiming) while other contexts of use expect that the modifiers will be combined with the main code (e.g. Procedure.code). When the modifiers are combined in a single field, modifiers are appended to the main code in any order using : as a separater (per established X12 usage):

  <coding>
    <system value="http://www.ama-assn.org/go/cpt"/>
    <version value="2023"/>
    <code value="21899:63"/>
  </coding>

Notes:

  • Tthe combination of base code and modifiers must be done according to the rules defined in the CPT documentation
  • Other separator characters are used in other contexts, including in the AMA documenation, notably - and .. Expressions using these separators are not conformant, and the separators must be replaced by :

CPT Concept Properties

This specification defines three properties that all CPT concepts have:

Name Cardinality Type Description
modifier 1..1 boolean True if the code is a 2 letter modifer code, and false otherwise. This property is defined to make it easy to define modifier only value sets (see value sets below)
modified 1..1 boolean Whether the code is an expression - i.e. whether it includes modifiers using the modifier syntax described above. All of the base codes defined in the CPT distribution have modified = false. This fairly trivial property is defined so it can be used in the filters below
kind 0..* code The kind of CPT code. The values may be one of:
  • code: A base CPT code
  • cat-1: CPT Level I Modifiers
  • cat-2: A Category II code or modifier
  • physical-status: Anesthesia Physical Status Modifiers
  • general: A general modifier
  • hcpcs: Level II (HCPCS/National) Modifiers
  • metadata: A kind of code or designation
All predefined concepts have a type. Concepts defined by an expression do not have a kind. Note that some concepts have more than one kind: some general modifiers are cat-1 modifiers, but not all are, and orthopox codes are also normal CPT codes.
orthopox 0..1 boolean Whether code is one of the Pathology and Laboratory and Immunization Code(s) for Orthopoxvirus. This code might be used in some value set filters
telemedicine 0..1 boolean Whether code is one of the Pathology and Laboratory and Immunization Code(s) for telemedicine. This code might be used in some value set filters, and is defined for use internally by terminology servers when validating expressions for modifier 95

CPT Filter Properties

This specification defines six filters that may be used with the CPT code system.

Name Operation(s) Value(s) Description
modifier = true or false Whether the code is a modifier or not (based on the modifier property). Typically, a value set would use modifier=false to specify base codes only, for example in Claim.item.detail.productOrService, while modifier=true woudl be used to specify modifier codes, for example in Claim.item.detail.modifier
kind =/in a kind from the list above, or a comma seperated list of kinds Select a kind of code from the list above
modified = true or false Whether an expression is allowed or not. A typical use of this would be with Procedure.code, a value set would specify two includes: kind in code,cat-2 and modified=true, to indicate that CPT codes might be a base CPT code or an expression.
code in a series of ranges seperated by commas Ranges may be a single code, or a range of codes e.g. 20100-69990, 92920, 92926-92928
telemedicine = true or false Select or unselect codes that are appropriate for use with the telemedicine modifier 95
orthopox = true or false Select or unselect codes that are marked as orthopox codes

CPT Implicit Value Sets

There are no general implicit value set formula defined for CPT, but there are four predefined value sets that implementers may find generally useful:

url Compose
http://hl7.org/fhir/ValueSet/cpt-all:
a value set that includes all CPT codes (including base codes, modifiers and internal metadata)
"compose" : {
    "include" : [{
      "system" : "http://www.ama-assn.org/go/cpt",
      "copyright" : "CPT © Copyright 2023 American Medical Association. All rights reserved. AMA and CPT are registered trademarks of the American Medical Association."
    }]
  }

Note that the include level copyright is an R5 feature. IN previous versions of FHIR, the copyright must go in ValueSet.copyright.
http://hl7.org/fhir/ValueSet/cpt-base:
All codes in CPT that represent procedure codes (no modifiers allowed - e.g. for Claim.item.productOrService)
  "compose" : {
    "include" : [{
      // plain codes (no modifiers)
      "system" : "http://www.ama-assn.org/go/cpt",
      "copyright" : "CPT © Copyright 2023 American Medical Association. All rights reserved. AMA and CPT are registered trademarks of the American Medical Association.",
      "filter" : [{
        "property" : "modified",
        "op" : "=",
        "value" : "false"
      },{
        "property" : "modifier",
        "op" : "=",
        "value" : "false"
      }] 
    }]
  }
http://hl7.org/fhir/ValueSet/cpt-modifiers:
CPT modifiers (e.g. for Claim.item.modifier)
  "compose" : {
    "include" : [{
      // only modifiers
      "system" : "http://www.ama-assn.org/go/cpt",
      "copyright" : "CPT © Copyright 2023 American Medical Association. All rights reserved. AMA and CPT are registered trademarks of the American Medical Association.",
      "filter" : [{
        "property" : "modifier",
        "op" : "=",
        "value" : "true"
      }] 
    }]
  }
http://hl7.org/fhir/ValueSet/cpt-usable:
All codes in CPT codes (no modifiers) that represent procedure codes (e.g. for Procedure.code).
  "compose" : {
    "include" : [{
      // plain codes (no modifiers)
      "system" : "http://www.ama-assn.org/go/cpt",
      "copyright" : "CPT © Copyright 2023 American Medical Association. All rights reserved. AMA and CPT are registered trademarks of the American Medical Association.",
      "filter" : [{
        "property" : "modified",
        "op" : "=",
        "value" : "false"
      },{
        "property" : "modifier",
        "op" : "=",
        "value" : "false"
      }] 
    },{
      // codes with modifiers (grammar enforces rules)
      "system" : "http://www.ama-assn.org/go/cpt",
      "filter" : [{
        "property" : "modified",
        "op" : "=",
        "value" : "true"
      }] 
    }]
  }

Using CPT with earlier versions of FHIR

This page documents the correct usage of CPT with R5, but the concepts apply to all versions of FHIR. Earlier versions of FHIR contained a 'Using CPT with HL7 FHIR RX page' (e.g. R4). This page should be understood to replace those earlier pages. Note that this pages defines additional valid codes, properties, filters and the expression syntax which add facilities not previously described, but do not otherwise invalidate the advice in those earlier pages.