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 and are not limited to physicians, nurses, pharmacists, therapists, technologists, and social workers.

The following fields are returned if valued:

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.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Practitioner?_id=1994021

Response

Status: 200 OK
{
  "resourceType": "Bundle",
  "id": "5c966d5a-966c-499b-aa3c-6f903a628dd8",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Practitioner?_id=1994021"
    }
  ],
  "entry": [
    {
      "fullUrl": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Practitioner/1994021",
      "resource": {
        "resourceType": "Practitioner",
        "id": "1994021",
        "meta": {
          "versionId": "0",
          "lastUpdated": "2013-11-04T13:25:17.000-06:00"
        },
        "text": {
          "status": "generated",
          "div": "<div><p><b>Practitioner</b></p><p><b>Name</b>: PCTAUT, OrdersPhy3</p><p><b>Identifiers</b>: DOCDEA: 234234123</p><p><b>Gender</b>: Male</p><p><b>Status</b>: Active</p></div>"
        },
        "identifier": [
          {
            "use": "usual",
            "type": {
              "text": "DOCDEA"
            },
            "value": "234234123",
            "period": {
              "start": "2013-11-08T00:00:00.000-06:00"
            }
          }
        ],
        "active": true,
        "name": {
          "use": "usual",
          "text": "PCTAUT, OrdersPhy3",
          "family": [
            "PCTAUT"
          ],
          "given": [
            "OrdersPhy3"
          ],
          "period": {
            "start": "2013-11-04T13:25:17.000-06:00"
          }
        },
        "telecom": [
          {
            "value": "8165550192",
            "use": "work"
          }
        ],
        "address": [
          {
            "use": "work",
            "text": "123 Main St.\nBirmingham, AL 56265\nUSA",
            "line": [
              "123 Main St."
            ],
            "city": "Birmingham",
            "state": "AL",
            "postalCode": "56265",
            "country": "USA"
          }
        ],
        "gender": "male"
      }
    }
  ]
}

Errors

The common errors may be returned.

Retrieve by id

List an individual Practitioner by its id:

GET /Practitioner/:id

Authorization Types

Headers

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

Example

Request

GET https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Practitioner/1994021

Response

Status: 200 OK
{
  "resourceType": "Practitioner",
  "id": "1994021",
  "meta": {
    "versionId": "0",
    "lastUpdated": "2013-11-04T13:25:17.000-06:00"
  },
  "text": {
    "status": "generated",
    "div": "<div><p><b>Practitioner</b></p><p><b>Name</b>: PCTAUT, OrdersPhy3</p><p><b>Identifiers</b>: DOCDEA: 234234123</p><p><b>Gender</b>: Male</p><p><b>Status</b>: Active</p></div>"
  },
  "identifier": [
    {
      "use": "usual",
      "type": {
        "text": "DOCDEA"
      },
      "value": "234234123",
      "period": {
        "start": "2013-11-08T00:00:00.000-06:00"
      }
    }
  ],
  "active": true,
  "name": {
    "use": "usual",
    "text": "PCTAUT, OrdersPhy3",
    "family": [
      "PCTAUT"
    ],
    "given": [
      "OrdersPhy3"
    ],
    "period": {
      "start": "2013-11-04T13:25:17.000-06:00"
    }
  },
  "telecom": [
    {
      "value": "8165550192",
      "use": "work"
    }
  ],
  "address": [
    {
      "use": "work",
      "text": "123 Main St.\nBirmingham, AL 56265\nUSA",
      "line": [
        "123 Main St."
      ],
      "city": "Birmingham",
      "state": "AL",
      "postalCode": "56265",
      "country": "USA"
    }
  ],
  "gender": "male"
}

Errors

The common errors may be returned.