Jump to

• Request
• Response

Get a practitioner by ID

get

/Practitioner/{id}

Note: The FHIR API endpoints described below are currently pending production deployment for electronic health record (EHR) environments. Developers are welcome and encouraged to develop against the specifications in anticipation of production availability, which will be announced at a later date.

Retrieves an individual practitioner by the associated ID.

Request

Path Parameters

• id(required): string
  The logical resource ID.

Header Parameters

• accept(required): string

  The media type to be requested.

  Example: application/fhir+json

• authorization(required): string
  The credentials to authenticate a consumer to the service. This should be the OAuth2 Bearer Token.

There's no request body for this operation.

Back to Top

Response

200 Response

Successful retrieve response.

Body ()

Root Schema : Practitioner

Type: object

Show Source

• address: array address
  The addresses of the practitioner.
• id(required): string
• identifier(required): array identifier
  An identifier for the person as this agent.
• name(required): array name
  The names associated with the practitioner.
• resourceType(required): string
  Allowed Values: [ "Practitioner" ]
• telecom: array telecom
  A contact detail for the practitioner that applies to all roles.

{
    "type":"object",
    "required":[
        "resourceType",
        "id",
        "identifier",
        "name"
    ],
    "properties":{
        "resourceType":{
            "type":"string",
            "enum":[
                "Practitioner"
            ]
        },
        "id":{
            "type":"string"
        },
        "identifier":{
            "type":"array",
            "description":"An identifier for the person as this agent.",
            "items":{
                "$ref":"#/components/schemas/Identifier"
            }
        },
        "name":{
            "type":"array",
            "description":"The names associated with the practitioner.",
            "items":{
                "$ref":"#/components/schemas/HumanName"
            }
        },
        "telecom":{
            "type":"array",
            "description":"A contact detail for the practitioner that applies to all roles.",
            "items":{
                "$ref":"#/components/schemas/ContactPoint"
            }
        },
        "address":{
            "type":"array",
            "description":"The addresses of the practitioner.",
            "items":{
                "$ref":"#/components/schemas/Address"
            }
        }
    }
}

Nested Schema : address

Type: array

The addresses of the practitioner.

Show Source

• Array of: object Address

{
    "type":"array",
    "description":"The addresses of the practitioner.",
    "items":{
        "$ref":"#/components/schemas/Address"
    }
}

Nested Schema : identifier

Type: array

An identifier for the person as this agent.

Show Source

• Array of: object Identifier

{
    "type":"array",
    "description":"An identifier for the person as this agent.",
    "items":{
        "$ref":"#/components/schemas/Identifier"
    }
}

Nested Schema : name

Type: array

The names associated with the practitioner.

Show Source

• Array of: object HumanName

{
    "type":"array",
    "description":"The names associated with the practitioner.",
    "items":{
        "$ref":"#/components/schemas/HumanName"
    }
}

Nested Schema : telecom

Type: array

A contact detail for the practitioner that applies to all roles.

Show Source

• Array of: object ContactPoint

{
    "type":"array",
    "description":"A contact detail for the practitioner that applies to all roles.",
    "items":{
        "$ref":"#/components/schemas/ContactPoint"
    }
}

Nested Schema : Address

Type: object

Show Source

• city: string
  The name of city, town, and so on.
• country: string
  The country, which can be the International Organization for Standardization (ISO) 3166 two-letter or three-letter code.
• line: array line
  The street name, number, direction, P.O. Box, and so on.
• postalCode: string
  The U.S. ZIP Codes.
• state: string
  The subunit of the country (abbreviations are supported).

{
    "type":"object",
    "properties":{
        "line":{
            "type":"array",
            "description":"The street name, number, direction, P.O. Box, and so on.",
            "items":{
                "type":"string"
            }
        },
        "city":{
            "type":"string",
            "description":"The name of city, town, and so on."
        },
        "state":{
            "type":"string",
            "description":"The subunit of the country (abbreviations are supported)."
        },
        "postalCode":{
            "type":"string",
            "description":"The U.S. ZIP Codes."
        },
        "country":{
            "type":"string",
            "description":"The country, which can be the International Organization for Standardization (ISO) 3166 two-letter or three-letter code."
        }
    }
}

Nested Schema : line

Type: array

The street name, number, direction, P.O. Box, and so on.

Show Source

• Array of: string

{
    "type":"array",
    "description":"The street name, number, direction, P.O. Box, and so on.",
    "items":{
        "type":"string"
    }
}

Nested Schema : Identifier

Type: object

Show Source

• system(required): string (uri)
• value(required): string

{
    "type":"object",
    "required":[
        "system",
        "value"
    ],
    "properties":{
        "system":{
            "type":"string",
            "format":"uri"
        },
        "value":{
            "type":"string"
        }
    }
}

Nested Schema : HumanName

Type: object

Show Source

• family(required): string
  The family name (often called the surname).

{
    "type":"object",
    "required":[
        "family"
    ],
    "properties":{
        "family":{
            "type":"string",
            "description":"The family name (often called the surname)."
        }
    }
}

Nested Schema : ContactPoint

Type: object

Show Source

• system: string
  (USCDI) The following values are supported:

  • phone
  • fax
  • email
  • pager
  • url
  • sms
  • other
• value: string
  The actual contact point details.

{
    "type":"object",
    "properties":{
        "system":{
            "type":"string",
            "description":"(USCDI) The following values are supported:\n  <ul>\n    <li><code>phone</code></li>\n    <li><code>fax</code></li>\n    <li><code>email</code></li>\n    <li><code>pager</code></li>\n    <li><code>url</code></li>\n    <li><code>sms</code></li>\n    <li><code>other</code></li>\n  </ul>\n"
        },
        "value":{
            "type":"string",
            "description":"The actual contact point details."
        }
    }
}

Default Response

An OperationOutcome describing any error that occurred.

Body ()

Root Schema : OperationOutcome

Type: object

Show Source

• issue(required): array issue
• resourceType(required): string
  Allowed Values: [ "OperationOutcome" ]

{
    "type":"object",
    "required":[
        "resourceType",
        "issue"
    ],
    "properties":{
        "resourceType":{
            "type":"string",
            "enum":[
                "OperationOutcome"
            ]
        },
        "issue":{
            "type":"array",
            "items":{
                "type":"object",
                "required":[
                    "severity",
                    "code"
                ],
                "properties":{
                    "severity":{
                        "type":"string"
                    },
                    "code":{
                        "type":"string"
                    }
                }
            }
        }
    }
}

Nested Schema : issue

Type: array

Show Source

• Array of: object items

{
    "type":"array",
    "items":{
        "type":"object",
        "required":[
            "severity",
            "code"
        ],
        "properties":{
            "severity":{
                "type":"string"
            },
            "code":{
                "type":"string"
            }
        }
    }
}

Nested Schema : items

Type: object

Show Source

• code(required): string
• severity(required): string

{
    "type":"object",
    "required":[
        "severity",
        "code"
    ],
    "properties":{
        "severity":{
            "type":"string"
        },
        "code":{
            "type":"string"
        }
    }
}

Back to Top