FHIR Extensions Pack
5.3.0 - May 2026 International flag

FHIR Extensions Pack, published by HL7 International / FHIR Infrastructure. This guide is not an authorized publication; it is the continuous build for version 5.3.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-extensions/ and changes regularly. See the Directory of published versions

: Authorization Hint - JSON Representation

Page standards status: Trial-use Maturity Level: 0

Raw json | Download

{
  "resourceType" : "CodeSystem",
  "id" : "authorization-hint",
  "meta" : {
    "profile" : [
      🔗 "http://hl7.org/fhir/StructureDefinition/shareablecodesystem"
    ]
  },
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: CodeSystem authorization-hint</b></p><a name=\"authorization-hint\"> </a><a name=\"hcauthorization-hint\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"http://hl7.org/fhir/R5/shareablecodesystem.html\">Shareable CodeSystem</a></p></div><p>This case-sensitive code system <code>http://hl7.org/fhir/CodeSystem/authorization-hint</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></tr><tr><td style=\"white-space:nowrap\">smart-app-launch<a name=\"authorization-hint-smart-app-launch\"> </a></td><td>SMART-on-FHIR Application Launch</td><td>Indicates that authorization should be performed as a SMART Application Launch. If a value is provided, it is an additional challenge token.</td></tr><tr><td style=\"white-space:nowrap\">smart-backend<a name=\"authorization-hint-smart-backend\"> </a></td><td>SMART-on-FHIR Backend Services</td><td>Indicates that authorization should be performed as SMART Backend Services. If a value is provided, it is an additional challenge token.</td></tr><tr><td style=\"white-space:nowrap\">challenge-token<a name=\"authorization-hint-challenge-token\"> </a></td><td>Challenge Token</td><td>Indicates that an additional challenge token is required for authorization.</td></tr><tr><td style=\"white-space:nowrap\">mutual-tls<a name=\"authorization-hint-mutual-tls\"> </a></td><td>Mutual TLS</td><td>Indicates that authorization should be performed using Mutual TLS certificates.</td></tr></table></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" : 0
    }
  ],
  "url" : "http://hl7.org/fhir/CodeSystem/authorization-hint",
  "version" : "5.3.0",
  "name" : "AuthorizationHint",
  "title" : "Authorization Hint",
  "status" : "active",
  "experimental" : false,
  "date" : "2026-09-28",
  "publisher" : "HL7 International / FHIR Infrastructure",
  "contact" : [
    {
      "telecom" : [
        {
          "system" : "url",
          "value" : "http://www.hl7.org/Special/committees/fiwg"
        }
      ]
    }
  ],
  "description" : "This code system defines a starter set of codes that can be used to indicate authorization hints.",
  "jurisdiction" : [
    {
      "coding" : [
        {
          "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code" : "001"
        }
      ]
    }
  ],
  "caseSensitive" : true,
  "content" : "complete",
  "concept" : [
    {
      "code" : "smart-app-launch",
      "display" : "SMART-on-FHIR Application Launch",
      "definition" : "Indicates that authorization should be performed as a SMART Application Launch. If a value is provided, it is an additional challenge token."
    },
    {
      "code" : "smart-backend",
      "display" : "SMART-on-FHIR Backend Services",
      "definition" : "Indicates that authorization should be performed as SMART Backend Services. If a value is provided, it is an additional challenge token."
    },
    {
      "code" : "challenge-token",
      "display" : "Challenge Token",
      "definition" : "Indicates that an additional challenge token is required for authorization."
    },
    {
      "code" : "mutual-tls",
      "display" : "Mutual TLS",
      "definition" : "Indicates that authorization should be performed using Mutual TLS certificates."
    }
  ]
}