FHIR Release 3 (STU) CI-Build

This page is part of the FHIR Specification (v3.0.2: STU 3). The current version which supercedes this version is 5.0.0 . For a full list Continuous Integration Build of available versions, see FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions . Page versions: R5 R4B R4 R3

Codesystem-administrative-gender.json

Example CodeSystem/administrative-gender (JSON)

Maturity Level : N/A
Vocabulary Responsible Owner: Patient Administration Work Group Ballot Standards Status : Informative

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

Definition for Code System AdministrativeGender SystemAdministrativeGender 

{
  "resourceType": "CodeSystem",
  "id": "administrative-gender",
  "meta": {
    "lastUpdated": "2019-10-24T11:53:00+11:00"

  "resourceType" : "CodeSystem",
  "id" : "administrative-gender",
  "meta" : {
    "lastUpdated" : "2025-11-09T02:03:16.847+00:00"

  },
  "text": {
    "status": "extensions",
    "div": "<div>!-- Snipped for Brevity --></div>"

  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: CodeSystem administrative-gender</b></p><a name=\"administrative-gender\"> </a><a name=\"hcadministrative-gender\"> </a><p><b>Properties</b></p><p><b>This code system defines the following properties for its concepts</b></p><table class=\"grid\"><tr><td><b>Name</b></td><td><b>Code</b></td><td><b>URI</b></td><td><b>Type</b></td></tr><tr><td>comments</td><td>comments</td><td>http://hl7.org/fhir/concept-properties#comments</td><td>string</td></tr></table><p><b>Concepts</b></p><p>This case-sensitive code system <code>http://hl7.org/fhir/administrative-gender</code> defines the following codes:</p><table class=\"codes\"><tr><td style=\"white-space:nowrap\"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td><td><b>Comments</b></td><td><b>comments</b></td></tr><tr><td style=\"white-space:nowrap\">male<a name=\"administrative-gender-male\"> </a></td><td>Male</td><td>Male.</td><td/><td>Male</td></tr><tr><td style=\"white-space:nowrap\">female<a name=\"administrative-gender-female\"> </a></td><td>Female</td><td>Female.</td><td/><td>Female</td></tr><tr><td style=\"white-space:nowrap\">other<a name=\"administrative-gender-other\"> </a></td><td>Other</td><td>Other.</td><td/><td>The administrative gender is a value other than male/female/unknown. Where this value is selected, systems may often choose to include an extension with the localized more specific value.</td></tr><tr><td style=\"white-space:nowrap\">unknown<a name=\"administrative-gender-unknown\"> </a></td><td>Unknown</td><td>Unknown.</td><td/><td>A proper value is applicable, but not known.  Usage Notes: This means the actual value is not known. If the only thing that is unknown is how to properly express the value in the necessary constraints (value set, datatype, etc.), then the OTH or UNC flavor should be used. No properties should be included for a datatype with this property unless:  Those properties themselves directly translate to a semantic of &quot;unknown&quot;. (E.g. a local code sent as a translation that conveys 'unknown') Those properties further qualify the nature of what is unknown. (E.g. specifying a use code of &quot;H&quot; and a URL prefix of &quot;tel:&quot; to convey that it is the home phone number that is unknown.)</td></tr></table></div>"

  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-ballot-status",
      "valueString": "Informative"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger": 5
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode": "pc"
    }
  ],
  "url": "http://hl7.org/fhir/administrative-gender",
  "identifier": {
    "system": "urn:ietf:rfc:3986",
    "value": "urn:oid:2.16.840.1.113883.4.642.1.2"

  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
    "valueCode" : "pa"

  },
  "version": "3.0.2",
  "name": "AdministrativeGender",
  "status": "draft",
  "experimental": false,
  "date": "2019-10-24T11:53:00+11:00",
  "description": "The gender of a person used for administrative purposes.",
  "caseSensitive": true,
  "valueSet": "http://hl7.org/fhir/ValueSet/administrative-gender",
  "content": "complete",
  "concept": [
    {
      "extension": [
        {
          "url": "http://hl7.org/fhir/StructureDefinition/codesystem-comments",
          "valueString": "Male"
        }
      ],
      "code": "male",
      "display": "Male",
      "definition": "Male"
    },
    {
      "extension": [
        {
          "url": "http://hl7.org/fhir/StructureDefinition/codesystem-comments",
          "valueString": "Female"
        }
      ],
      "code": "female",
      "display": "Female",
      "definition": "Female"
    },
    {
      "extension": [
        {
          "url": "http://hl7.org/fhir/StructureDefinition/codesystem-comments",
          "valueString": "The gender of a person could not be uniquely defined as male or female, such as hermaphrodite."
        }
      ],
      "code": "other",
      "display": "Other",
      "definition": "Other"
    },
    {
      "extension": [
        {
          "url": "http://hl7.org/fhir/StructureDefinition/codesystem-comments",
          "valueString": "Description:A proper value is applicable, but not known.  Usage Notes: This means the actual value is not known. If the only thing that is unknown is how to properly express the value in the necessary constraints (value set, datatype, etc.), then the OTH or UNC flavor should be used. No properties should be included for a datatype with this property unless:  Those properties themselves directly translate to a semantic of \"unknown\". (E.g. a local code sent as a translation that conveys 'unknown') Those properties further qualify the nature of what is unknown. (E.g. specifying a use code of \"H\" and a URL prefix of \"tel:\" to convey that it is the home phone number that is unknown.)"
        }
      ],
      "code": "unknown",
      "display": "Unknown",
      "definition": "Unknown"
    }
  ]

  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
    "valueCode" : "normative"
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 5
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-normative-version",
    "valueCode" : "4.0.0"
  }],
  "url" : "http://hl7.org/fhir/administrative-gender",
  "identifier" : [{
    "system" : "urn:ietf:rfc:3986",
    "value" : "urn:oid:2.16.840.1.113883.4.642.4.2"
  }],
  "version" : "6.0.0-ballot3",
  "name" : "AdministrativeGender",
  "title" : "AdministrativeGender",
  "status" : "active",
  "experimental" : false,
  "date" : "2025-11-09T02:03:16+00:00",
  "publisher" : "HL7 International / Patient Administration",
  "contact" : [{
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org/Special/committees/pafm"
    }]
  }],
  "description" : "The gender of a person used for administrative purposes.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
      "code" : "001",
      "display" : "World"
    }]
  }],
  "caseSensitive" : true,
  "valueSet" : "http://hl7.org/fhir/ValueSet/administrative-gender",
  "content" : "complete",
  "property" : [{
    "code" : "comments",
    "uri" : "http://hl7.org/fhir/concept-properties#comments",
    "type" : "string"
  }],
  "concept" : [{
    "code" : "male",
    "display" : "Male",
    "definition" : "Male.",
    "property" : [{
      "code" : "comments",
      "valueString" : "Male"
    }]
  },
  {
    "code" : "female",
    "display" : "Female",
    "definition" : "Female.",
    "property" : [{
      "code" : "comments",
      "valueString" : "Female"
    }]
  },
  {
    "code" : "other",
    "display" : "Other",
    "definition" : "Other.",
    "property" : [{
      "code" : "comments",
      "valueString" : "The administrative gender is a value other than male/female/unknown. Where this value is selected, systems may often choose to include an extension with the localized more specific value."
    }]
  },
  {
    "code" : "unknown",
    "display" : "Unknown",
    "definition" : "Unknown.",
    "property" : [{
      "code" : "comments",
      "valueString" : "A proper value is applicable, but not known.  Usage Notes: This means the actual value is not known. If the only thing that is unknown is how to properly express the value in the necessary constraints (value set, datatype, etc.), then the OTH or UNC flavor should be used. No properties should be included for a datatype with this property unless:  Those properties themselves directly translate to a semantic of \"unknown\". (E.g. a local code sent as a translation that conveys 'unknown') Those properties further qualify the nature of what is unknown. (E.g. specifying a use code of \"H\" and a URL prefix of \"tel:\" to convey that it is the home phone number that is unknown.)"
    }]
  }]

}

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.