Release 5 FHIR CI-Build

This page is part of the Continuous Integration Build of FHIR Specification (v5.0.0: R5 - STU ). This is the current published version in it's permanent home (it will always (will be available incorrect/inconsistent at this URL). For a full list of available versions, see times).
See the Directory of published versions . Page versions: R5 R4B R4 R3 R2

Example ValueSet/age-units (JSON)

Maturity Level : N/A
Responsible Owner: Terminology Infrastructure Work Group Standards Status : Informative

Raw JSON ( canonical form + also see JSON Format Specification )

Definition for Value SetCommon UCUM Codes for Age

{
  "resourceType" : "ValueSet",
  "id" : "age-units",
  "meta" : {
    "lastUpdated" : "2023-03-26T15:21:02.749+11:00",
    "profile" : ["http://hl7.org/fhir/StructureDefinition/shareablevalueset"]

    "lastUpdated" : "2025-11-24T20:46:00.100+00:00"

  },
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><ul><li>Include these codes as defined in <a href=\"http://unitsofmeasure.org\"><code>http://unitsofmeasure.org</code></a><table class=\"none\"><tr><td style=\"white-space:nowrap\"><b>Code</b></td><td><b>Display</b></td></tr><tr><td>min</td><td>minutes</td></tr><tr><td>h</td><td>hours</td></tr><tr><td>d</td><td>days</td></tr><tr><td>wk</td><td>weeks</td></tr><tr><td>mo</td><td>months</td></tr><tr><td>a</td><td>years</td></tr></table></li></ul></div>"

    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: ValueSet age-units</b></p><a name=\"age-units\"> </a><a name=\"hcage-units\"> </a><ul><li>Include these codes as defined in <a href=\"http://unitsofmeasure.org\"><code>http://unitsofmeasure.org</code></a><span title=\"Version is not explicity stated. No matching Code System found\"> version Not Stated (use latest from terminology server)</span><table class=\"none\"><tr><td style=\"white-space:nowrap\"><b>Code</b></td><td><b>Display</b></td></tr><tr><td>min</td><td>min</td></tr><tr><td>h</td><td>hour</td></tr><tr><td>d</td><td>day</td></tr><tr><td>wk</td><td>week</td></tr><tr><td>mo</td><td>month</td></tr><tr><td>a</td><td>year</td></tr></table></li></ul></div>"

  },
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
    "valueCode" : "fhir"
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
    "valueCode" : "trial-use"
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 5

    "valueCode" : "normative"

  }],
  "url" : "http://hl7.org/fhir/ValueSet/age-units",
  "identifier" : [{
    "system" : "urn:ietf:rfc:3986",
    "value" : "urn:oid:2.16.840.1.113883.4.642.3.19"
  }],
  "version" : "5.0.0",

  "version" : "6.0.0-ballot3",

  "name" : "CommonUCUMCodesForAge",
  "title" : "Common UCUM Codes for Age",
  "status" : "draft",
  "experimental" : true,
  "date" : "2023-03-26T15:21:02+11:00",
  "publisher" : "FHIR Project team",

  "status" : "active",
  "experimental" : false,
  "date" : "2025-11-24T20:46:00+00:00",
  "publisher" : "HL7 International / FHIR Infrastructure",

  "contact" : [{
    "telecom" : [{
      "system" : "url",
      "value" : "http://hl7.org/fhir"

      "value" : "http://www.hl7.org/Special/committees/fiwg"

    }]
  }],
  "description" : "Unified Code for Units of Measure (UCUM). This value set includes all common UCUM codes used for Age - that it is, all commonly used units which have the same canonical unit as 'a' (year)",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
      "code" : "001",
      "display" : "World"
    }]
  }],
  "copyright" : "The UCUM codes, UCUM table (regardless of format), and UCUM Specification are copyright © 1999-2009, Regenstrief Institute, Inc. and the Unified Codes for Units of Measures (UCUM) Organization. All rights reserved.",
  "compose" : {
    "include" : [{
      "system" : "http://unitsofmeasure.org",
      "concept" : [{
        "code" : "min",
        "display" : "minutes"

        "display" : "min"

      },
      {
        "code" : "h",
        "display" : "hours"

        "display" : "hour"

      },
      {
        "code" : "d",
        "display" : "days"

        "display" : "day"

      },
      {
        "code" : "wk",
        "display" : "weeks"

        "display" : "week"

      },
      {
        "code" : "mo",
        "display" : "months"

        "display" : "month"

      },
      {
        "code" : "a",
        "display" : "years"

        "display" : "year"

      }]
    }]
  }
}

Usage note: every effort has been made to ensure that the examples are correct and useful, but they are not a normative part of the specification.