---
type: "search-params"
title: "Practitioner Search Parameters"
resource: "Practitioner"
---
# Practitioner Search Parameters

<a id="active"></a>

## active
**Description:** Whether the practitioner record is active

**Type:** token

**Expression:** Practitioner.active

**Path:** Practitioner.active

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-active


<a id="address"></a>

## address
**Description:** A server defined search that may match any of the string fields in the Address, including line, city, district, state, country, postalCode, and/or text

**Type:** string

**Expression:** Practitioner.address

**Path:** Practitioner.address

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-address


<a id="address-city"></a>

## address-city
**Description:** A city specified in an address

**Type:** string

**Expression:** Practitioner.address.city

**Path:** Practitioner.address.city

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-address-city


<a id="address-country"></a>

## address-country
**Description:** A country specified in an address

**Type:** string

**Expression:** Practitioner.address.country

**Path:** Practitioner.address.country

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-address-country


<a id="address-postalcode"></a>

## address-postalcode
**Description:** A postalCode specified in an address

**Type:** string

**Expression:** Practitioner.address.postalCode

**Path:** Practitioner.address.postalCode

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-address-postalcode


<a id="address-state"></a>

## address-state
**Description:** A state specified in an address

**Type:** string

**Expression:** Practitioner.address.state

**Path:** Practitioner.address.state

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-address-state


<a id="address-use"></a>

## address-use
**Description:** A use code specified in an address

**Type:** token

**Expression:** Practitioner.address.use

**Path:** Practitioner.address.use

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-address-use


<a id="communication"></a>

## communication
**Description:** A language to communicate with the practitioner

**Type:** token

**Expression:** Practitioner.communication.language

**Path:** Practitioner.communication.language

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-communication


<a id="email"></a>

## email
**Description:** A value in an email contact

**Type:** token

**Expression:** Practitioner.telecom.where(system='email')

**Path:** Practitioner.telecom(system=email)

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-email


<a id="family"></a>

## family
**Description:** A portion of the family name

**Type:** string

**Expression:** Practitioner.name.family

**Path:** Practitioner.name.family

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-family


<a id="gender"></a>

## gender
**Description:** Gender of the practitioner

**Type:** token

**Expression:** Practitioner.gender

**Path:** Practitioner.gender

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-gender


<a id="given"></a>

## given
**Description:** A portion of the given name

**Type:** string

**Expression:** Practitioner.name.given

**Path:** Practitioner.name.given

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-given


<a id="identifier"></a>

## identifier
**Description:** A practitioner's Identifier

**Type:** token

**Expression:** Practitioner.identifier | Practitioner.qualification.identifier

**Path:** Practitioner.identifier | Practitioner.qualification.identifier

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-identifier


<a id="qualification-code"></a>

## qualification-code
**Description:** The type of qualification

**Type:** token

**Expression:** Practitioner.qualification.code

**Path:** Practitioner.qualification.code

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-qualification-code


<a id="qualification-period"></a>

## qualification-period
**Description:** The date(s) a qualification is valid for

**Type:** date

**Expression:** Practitioner.qualification.period

**Path:** Practitioner.qualification.period

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-qualification-period


<a id="qual-code-period"></a>

## qual-code-period
**Description:** The practitioner has a qualification during a specific period

**Type:** composite

**Expression:** Practitioner.qualification

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-qual-code-period


<a id="name"></a>

## name
**Description:** A server defined search that may match any of the string fields in the HumanName, including family, give, prefix, suffix, suffix, and/or text

**Type:** string

**Expression:** Practitioner.name

**Path:** Practitioner.name

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-name


<a id="phone"></a>

## phone
**Description:** A value in a phone contact

**Type:** token

**Expression:** Practitioner.telecom.where(system='phone')

**Path:** Practitioner.telecom(system=phone)

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-phone


<a id="phonetic"></a>

## phonetic
**Description:** A portion of either family or given name using some kind of phonetic matching algorithm

**Type:** string

**Expression:** Practitioner.name

**Path:** Practitioner.name

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-phonetic


<a id="telecom"></a>

## telecom
**Description:** The value in any kind of contact

**Type:** token

**Expression:** Practitioner.telecom

**Path:** Practitioner.telecom

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-telecom


<a id="death-date"></a>

## death-date
**Description:** The date of death has been provided and satisfies this search value

**Type:** date

**Expression:** (Practitioner.deceased.ofType(dateTime))

**Path:** Practitioner.deceasedDateTime

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-death-date


<a id="deceased"></a>

## deceased
**Description:** This Practitioner has been marked as deceased, or has a death date entered

**Type:** token

**Expression:** Practitioner.deceased.exists() and Practitioner.deceased != false

**Path:** Practitioner.deceased[x]

**Standards Status:** normative

**URL:** http://hl7.org/fhir/build/SearchParameter/Practitioner-deceased