FHIR © HL7.org  |  FHIRsmith 4.0.1  |  Server Home  |  XIG Home  |  XIG Stats  | 

FHIR IG analytics

Packageuz.dhp.core
Resource TypeOperationDefinition
IdOperationDefinition-practitioner-specializations.json
FHIR VersionR5
Sourcehttps://build.fhir.org/ig/uzinfocom-org/digital-health-ig/OperationDefinition-practitioner-specializations.html
URLhttps://dhp.uz/fhir/core/OperationDefinition/practitioner-specializations
Version0.8.0
Statusactive
Date2026-08-13
NamePractitionerSpecializations
TitleFetch active roles and specialties of a practitioner
DescriptionReturns the active roles (PractitionerRole) of the given practitioner together with the organizations where those roles are held. Each role carries the specialty (PractitionerRole.specialty), the job title (PractitionerRole.code) and the place of work (PractitionerRole.organization), so the operation gives the full picture of the practitioner's professional activity in a single request. Only roles that have not been deleted and whose `active` is not false are included; the roles are ordered by creation date, newest first. The organizations the roles reference are added to the same Bundle as accompanying entries (search.mode = `include`) and deduplicated: each organization appears at most once. The operation is invoked at instance level only (Practitioner/[id]/$specializations) with GET and takes no input parameters. The practitioner identifier must be a valid UUID, otherwise an OperationOutcome with code `invalid` and HTTP 400 is returned. If there are no active roles, HTTP 200 is returned with a Bundle containing an OperationOutcome with code `not-found`.
Typefalse
Kindoperation

Resources that use this resource

CapabilityStatement
uz.dhp.core#currentDHPCapabilityStatement

Resources that this resource uses

No resources found


Narrative

Note: links and images are rebased to the (stated) source


English


Generated Narrative: OperationDefinition practitioner-specializations

URL: [base]/Practitioner/[id]/$specializations

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
OUTreturn1..1Bundle

A searchset Bundle. The PractitionerRole entries are marked search.mode = match, the related Organization entries search.mode = include. Warnings about organizations that were not found are added as OperationOutcome entries. When there are no active roles, the Bundle contains a single OperationOutcome with severity not-found.

If a role references an organization that cannot be found or has been deleted, the role is still returned and a warning OperationOutcome with code not-found and text of the form "Organization referenced by PractitionerRole/[id] was not found" is added to the Bundle. Such warnings do not affect the response code (HTTP 200) and are not counted in Bundle.total, which counts only the PractitionerRole entries. The operation returns all of the practitioner's active roles at once; paging is not supported.


Russian


Сгенерированный нарратив: OperationDefinition practitioner-specializations

URL: [base]/Practitioner/[id]/$specializations

Параметры

ИспользоватьНаименованиеСфера действияКардинальностьТипПривязкаДокументация
OUTreturn1..1Bundle

A searchset Bundle. The PractitionerRole entries are marked search.mode = match, the related Organization entries search.mode = include. Warnings about organizations that were not found are added as OperationOutcome entries. When there are no active roles, the Bundle contains a single OperationOutcome with severity not-found.

If a role references an organization that cannot be found or has been deleted, the role is still returned and a warning OperationOutcome with code not-found and text of the form "Organization referenced by PractitionerRole/[id] was not found" is added to the Bundle. Such warnings do not affect the response code (HTTP 200) and are not counted in Bundle.total, which counts only the PractitionerRole entries. The operation returns all of the practitioner's active roles at once; paging is not supported.


Uzbek


Generated Narrative: OperationDefinition practitioner-specializations

URL: [base]/Practitioner/[id]/$specializations

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
OUTreturn1..1Bundle

A searchset Bundle. The PractitionerRole entries are marked search.mode = match, the related Organization entries search.mode = include. Warnings about organizations that were not found are added as OperationOutcome entries. When there are no active roles, the Bundle contains a single OperationOutcome with severity not-found.

If a role references an organization that cannot be found or has been deleted, the role is still returned and a warning OperationOutcome with code not-found and text of the form "Organization referenced by PractitionerRole/[id] was not found" is added to the Bundle. Such warnings do not affect the response code (HTTP 200) and are not counted in Bundle.total, which counts only the PractitionerRole entries. The operation returns all of the practitioner's active roles at once; paging is not supported.


Source1

{
  "resourceType": "OperationDefinition",
  "id": "practitioner-specializations",
  "text": {
    "status": "generated",
    "div": "<!-- snip (see above) -->"
  },
  "url": "https://dhp.uz/fhir/core/OperationDefinition/practitioner-specializations",
  "version": "0.8.0",
  "name": "PractitionerSpecializations",
  "title": "Fetch active roles and specialties of a practitioner",
  "status": "active",
  "kind": "operation",
  "experimental": false,
  "date": "2026-08-13",
  "publisher": "Ministry of Health of the Republic of Uzbekistan",
  "_publisher": {
    "extension": [
      {
        "extension": [
          {
            "url": "lang",
            "valueCode": "uz"
          },
          {
            "url": "content",
            "valueString": "O‘zbekiston Respublikasi Sog‘liqni saqlash vazirligi"
          }
        ],
        "url": "http://hl7.org/fhir/StructureDefinition/translation"
      },
      {
        "extension": [
          {
            "url": "lang",
            "valueCode": "ru"
          },
          {
            "url": "content",
            "valueString": "Ministry of Health of the Republic of Uzbekistan"
          }
        ],
        "url": "http://hl7.org/fhir/StructureDefinition/translation"
      }
    ]
  },
  "contact": [
    {
      "name": "Ministry of Health of the Republic of Uzbekistan",
      "telecom": [
        {
          "system": "url",
          "value": "https://gov.uz/en/ssv"
        },
        {
          "system": "email",
          "value": "info@ssv.uz"
        }
      ]
    }
  ],
  "description": "Returns the active roles (PractitionerRole) of the given practitioner together with the organizations where those roles are held. Each role carries the specialty (PractitionerRole.specialty), the job title (PractitionerRole.code) and the place of work (PractitionerRole.organization), so the operation gives the full picture of the practitioner's professional activity in a single request. Only roles that have not been deleted and whose `active` is not false are included; the roles are ordered by creation date, newest first. The organizations the roles reference are added to the same Bundle as accompanying entries (search.mode = `include`) and deduplicated: each organization appears at most once. The operation is invoked at instance level only (Practitioner/[id]/$specializations) with GET and takes no input parameters. The practitioner identifier must be a valid UUID, otherwise an OperationOutcome with code `invalid` and HTTP 400 is returned. If there are no active roles, HTTP 200 is returned with a Bundle containing an OperationOutcome with code `not-found`.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "urn:iso:std:iso:3166",
          "code": "UZ",
          "display": "Uzbekistan"
        }
      ]
    }
  ],
  "affectsState": false,
  "code": "specializations",
  "comment": "If a role references an organization that cannot be found or has been deleted, the role is still returned and a warning OperationOutcome with code `not-found` and text of the form \"Organization referenced by PractitionerRole/[id] was not found\" is added to the Bundle. Such warnings do not affect the response code (HTTP 200) and are not counted in Bundle.total, which counts only the PractitionerRole entries. The operation returns all of the practitioner's active roles at once; paging is not supported.",
  "resource": [
    "Practitioner"
  ],
  "system": false,
  "type": false,
  "instance": true,
  "parameter": [
    {
      "name": "return",
      "use": "out",
      "min": 1,
      "max": "1",
      "documentation": "A `searchset` Bundle. The PractitionerRole entries are marked search.mode = `match`, the related Organization entries search.mode = `include`. Warnings about organizations that were not found are added as OperationOutcome entries. When there are no active roles, the Bundle contains a single OperationOutcome with severity `not-found`.",
      "type": "Bundle"
    }
  ]
}