# Practitioner

Model ID: `Practitioner`

FHIR Practitioner resource, bidirectionally mapped via to_fhir()/from_fhir().

Type: `object`

## Fields

| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|---|---|---:|---|---|---|---:|---|
| `active` | `boolean` | No |  |  | `true` | No | False marks the record inactive without deleting it. |
| `address` | [`Address`](./Address.md) | No |  |  | `null` | Yes | Practice or mailing address, optional. |
| `birth_date` | `string|null` | No |  |  | `null` | Yes | ISO 8601 date of birth, optional. |
| `board_certifications` | `array` | No |  |  |  | No | Board certification names, optional. |
| `credential` | `string|null` | No |  |  | `null` | Yes | MD, DO, NP, PA, RN, etc. |
| `department` | `string|null` | No |  |  | `null` | Yes | Department within the organization, optional. |
| `education_credentials` | array of [`ProviderEducationCredential`](./ProviderEducationCredential.md) | No |  |  |  | No | Degrees and education credentials held by this practitioner. |
| `email` | `string|null` | No |  |  | `null` | Yes | Email address, optional. |
| `fhir_id` | `string|null` | No |  |  | `null` | Yes | FHIR Practitioner resource ID; set once the record has been persisted. |
| `first_name` | `string` | Yes |  |  |  | No | Given name. |
| `gender` | [`ProviderGender`](./ProviderGender.md) | No |  |  | `"unknown"` | No | Administrative gender. |
| `graduation_year` | `integer|null` | No |  |  | `null` | Yes | Graduation year, optional. |
| `identifiers` | array of [`ProviderIdentifier`](./ProviderIdentifier.md) | No |  |  |  | No | Additional external identifiers (DEA, tax ID, provider number, etc.) beyond NPI and state licenses. |
| `insurances_accepted` | array of [`ProviderAcceptedInsurance`](./ProviderAcceptedInsurance.md) | No |  |  |  | No | Insurance payers this practitioner accepts. |
| `languages_spoken` | array of [`ProviderLanguage`](./ProviderLanguage.md) | No |  |  |  | No | Languages this practitioner can communicate with patients in. |
| `last_name` | `string` | Yes |  |  |  | No | Family name. |
| `medical_school` | `string|null` | No |  |  | `null` | Yes | Medical school attended, optional. |
| `middle_name` | `string|null` | No |  |  | `null` | Yes | Middle name, optional. |
| `notes` | `string|null` | No |  |  | `null` | Yes | Free-text internal notes, optional. |
| `npi` | `string|null` | No |  |  | `null` | Yes | 10-digit NPI |
| `organization_id` | `string|null` | No |  |  | `null` | Yes | Identifier of the affiliated organization, optional. |
| `organization_name` | `string|null` | No |  |  | `null` | Yes | Display name of the affiliated organization, optional. |
| `practitioner_id` | `string` | No | uuid |  |  | No | Internal identifier generated at construction time; the FHIR resource id (fhir_id) is the one used on the wire as {practitioner_id}. |
| `prefix` | `string|null` | No |  |  | `null` | Yes | Name prefix, e.g. 'Dr.'. |
| `race` | array of [`Race`](./Race.md) | No |  |  |  | No | One or more race values, optional. |
| `roles` | array of [`ProviderRole`](./ProviderRole.md) | No |  |  |  | No | NUCC provider taxonomy high-level categories this practitioner practices under. |
| `specialties` | array of [`ProviderSpecialty`](./ProviderSpecialty.md) | No |  |  |  | No | Clinical specialties, coded to a taxonomy system (NUCC by default). Sent/received on the wire as 'specialty'. |
| `state_licenses` | array of [`ProviderStateLicense`](./ProviderStateLicense.md) | No |  |  |  | No | State medical licenses held by this practitioner. |
| `suffix` | `string|null` | No |  |  | `null` | Yes | Name suffix, e.g. 'Jr.'. |
| `telecom` | array of [`ProviderContactPoint`](./ProviderContactPoint.md) | No |  |  |  | No | Additional contact points (phone, fax, pager) beyond email. |

## Example

None declared in canonical OpenAPI.