Practitioner - FHIR Resource (r4)


This Practitioner Resource uses the FHIR API standard for access and structure.

Validate an Practitioner FHIR Resource (r4)



Resource Attributes

AttributeField is listTypeDescription
activefalseboolean# Whether this practitioner's record is in active use
addresstrueAddress# Address(es) of the practitioner that are not role specific (typically home address)
birthDatefalsedate# The date on which the practitioner was born
communicationtrueCodeableConcept# A language the practitioner can use in patient communication
genderfalsecode# male | female | other | unknown
identifiertrueIdentifier# An identifier for the person as this agent
nametrueHumanName# The name(s) associated with the practitioner
phototrueAttachment# Image of the person
qualificationtrueData Type# Certification, licenses, or training pertaining to the provision of care
telecomtrueContactPoint# A contact detail for the practitioner (that apply to all roles)

Practitioner Example

{
  "resourceType": "Practitioner",
  "id": "example",
  "text": {
    "status": "generated",
    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">\n      <p>Dr Adam Careful is a Referring Practitioner for Acme Hospital from 1-Jan 2012 to 31-Mar\n        2012</p>\n    </div>"
  },
  "identifier": [
    {
      "system": "http://www.acme.org/practitioners",
      "value": "23"
    }
  ],
  "active": true,
  "name": [
    {
      "family": "Careful",
      "given": [
        "Adam"
      ],
      "prefix": [
        "Dr"
      ]
    }
  ],
  "address": [
    {
      "use": "home",
      "line": [
        "534 Erewhon St"
      ],
      "city": "PleasantVille",
      "state": "Vic",
      "postalCode": "3999"
    }
  ],
  "qualification": [
    {
      "identifier": [
        {
          "system": "http://example.org/UniversityIdentifier",
          "value": "12345"
        }
      ],
      "code": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/v2-0360/2.7",
            "code": "BS",
            "display": "Bachelor of Science"
          }
        ],
        "text": "Bachelor of Science"
      },
      "period": {
        "start": "1995"
      },
      "issuer": {
        "display": "Example University"
      }
    }
  ]
}

Practitioner Structure

{
  "resourceType" : "Practitioner",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // An identifier for the person as this agent
  "active" : <boolean>, // Whether this practitioner's record is in active use
  "name" : [{ HumanName }], // The name(s) associated with the practitioner
  "telecom" : [{ ContactPoint }], // A contact detail for the practitioner (that apply to all roles)
  "address" : [{ Address }], // Address(es) of the practitioner that are not role specific (typically home address)
  "gender" : "<code>", // male | female | other | unknown
  "birthDate" : "<date>", // The date  on which the practitioner was born
  "photo" : [{ Attachment }], // Image of the person
  "qualification" : [{ // Certification, licenses, or training pertaining to the provision of care
    "identifier" : [{ Identifier }], // An identifier for this qualification for the practitioner
    "code" : { CodeableConcept }, // R!  Coded representation of the qualification
    "period" : { Period }, // Period during which the qualification is valid
    "issuer" : { Reference(Organization) } // Organization that regulates and issues the qualification
  }],
  "communication" : [{ CodeableConcept }] // A language the practitioner can use in patient communication
}

Practitioner Search Parameters

The following search parameters can be used to query Practitioner resources. Just submit them like so:

https://api.1up.health/fhir/r4/Practitioner?query-param=queryvalue
Search ParameterField TypeResource Fields Searched
activetextactive
addresstextaddress
address-citytextaddress.city
address-countrytextaddress.country
address-postalcodetextaddress.postalCode
address-statetextaddress.state
address-usetextaddress.use
communicationtextcommunication
emailtexttelecom.where
familytextname.family
gendertextgender
giventextname.given
identifiertextidentifier
nametextname
phonetexttelecom.where
phonetictextname
telecomtexttelecom