Practitioner

Overview

The Practitioner resource provides information about a person formally involved in the care of a patient on behalf of a healthcare facility. Practitioners include but are not limited to physicians, nurses, pharmacists, therapists, technologists, and social workers.

The following fields are returned if valued:

Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.

Errors

The common errors and OperationOutcomes may be returned.

Terminology Bindings

Practitioner.identifier.type
  • Description
    • The type used to determine which identifier to use for a specific purpose.
  • Details: Identifier Type Codes
    System: http://hl7.org/fhir/identifier-type

  • Details: v2 Identifier Type
    System: http://hl7.org/fhir/v2/0203

Search for practitioners that meet supplied query parameters.

GET /Practitioner?:parameters

Authorization Types

Parameters

Name Required? Type Description
_id Yes token The logical resource ID associated with the resource.

Headers

Accept: application/json+fhir
Authorization: <OAuth2 Bearer Token>

Example

Request

GET https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Practitioner?_id=4122622

Response

Status: 200 OK
{
  "resourceType": "Bundle",
  "id": "b9c0e2fa-cba0-4325-ae5f-4b5bd9916d86",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Practitioner?_id=4122622"
    }
  ],
  "entry": [
    {
      "fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Practitioner/4122622",
      "resource": {
        "resourceType": "Practitioner",
        "id": "4122622",
        "meta": {
          "versionId": "19",
          "lastUpdated": "2021-07-01T13:16:02.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div><p><b>Practitioner</b></p><p><b>Name</b>: Cerner Test, Physician - Hospitalist Cerner</p><p><b>Identifiers</b>: NPI: 1111111111</p><p><b>Status</b>: Active</p></div>"
        },
        "identifier": [
          {
            "use": "usual",
            "type": {
              "coding": [
                {
                  "system": "http://hl7.org/fhir/v2/0203",
                  "code": "NPI",
                  "display": "National provider identifier"
                }
              ],
              "text": "National Provider Identifier"
            },
            "system": "http://hl7.org/fhir/sid/us-npi",
            "value": "1111111111",
            "period": {
              "start": "2015-10-14T05:00:00.000Z"
            }
          }
        ],
        "active": true,
        "name": {
          "use": "usual",
          "text": "Cerner Test, Physician - Hospitalist Cerner",
          "family": [
            "Cerner Test"
          ],
          "given": [
            "Physician - Hospitalist",
            "Cerner"
          ],
          "period": {
            "start": "2015-09-22T20:58:42.000Z"
          }
        }
      }
    }
  ]
}

Retrieve by ID

List an individual practitioner by their ID.

GET /Practitioner/:id

Authorization Types

Headers

Accept: application/json+fhir
Authorization: <OAuth2 Bearer Token>

Example

Request

GET https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Practitioner/4122622

Response

Status: 200 OK
{
  "resourceType": "Practitioner",
  "id": "4122622",
  "meta": {
    "versionId": "19",
    "lastUpdated": "2021-07-01T13:16:02.000Z"
  },
  "text": {
    "status": "generated",
    "div": "<div><p><b>Practitioner</b></p><p><b>Name</b>: Cerner Test, Physician - Hospitalist Cerner</p><p><b>Identifiers</b>: NPI: 1111111111</p><p><b>Status</b>: Active</p></div>"
  },
  "identifier": [
    {
      "use": "usual",
      "type": {
        "coding": [
          {
            "system": "http://hl7.org/fhir/v2/0203",
            "code": "NPI",
            "display": "National provider identifier"
          }
        ],
        "text": "National Provider Identifier"
      },
      "system": "http://hl7.org/fhir/sid/us-npi",
      "value": "1111111111",
      "period": {
        "start": "2015-10-14T05:00:00.000Z"
      }
    }
  ],
  "active": true,
  "name": {
    "use": "usual",
    "text": "Cerner Test, Physician - Hospitalist Cerner",
    "family": [
      "Cerner Test"
    ],
    "given": [
      "Physician - Hospitalist",
      "Cerner"
    ],
    "period": {
      "start": "2015-09-22T20:58:42.000Z"
    }
  }
}