ModMed Patient API

openapi: 3.2.0
info:
  title: Modernizing Medicine Patient API
  version: '1.0'
  description: 'Operations tagged Patient across 2 of this provider''s published API definitions: modernizing-medicine-certified-fhir-api-openapi.json, modernizing-medicine-ema-proprietary-api-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://fhirmp.mmi.prod.fhir.ema-api.com/fhir/r4
  description: EMA Certified FHIR API
  variables:
    firm:
      default: fhirmp
      description: Your firm subdomain (e.g. fhirmp, auraderm). Find yours at https://mm-fhir-endpoint-display.prod.fhir.ema-api.com/
- url: https://stage.ema-api.com/ema-dev/firm/apiportal/ema
tags:
- name: Patient
  description: 'The Patient FHIR resource type<br/>Base profile: http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient'
paths:
  /Patient/$export:
    servers:
    - url: https://fhirmp.mmi.prod.fhir.ema-api.com/fhir/r4
      description: EMA Certified FHIR API
      variables:
        firm:
          default: fhirmp
          description: Your firm subdomain (e.g. fhirmp, auraderm). Find yours at https://mm-fhir-endpoint-display.prod.fhir.ema-api.com/
    get:
      tags:
      - Patient
      summary: 'GET: /Patient/$export'
      parameters:
      - name: _outputFormat
        in: query
        required: false
        schema:
          type: string
      - name: _since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: date-time
          - type: string
            format: date
      - name: _type
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
            application/fhir+xml:
              schema:
                $ref: '#/components/schemas/FHIR-XML-RESOURCE'
      security:
      - smartOnFhir:
        - openid
        - fhirUser
        - profile
        - launch/patient
        - offline_access
        - patient/AllergyIntolerance.rs
        - patient/CarePlan.rs
        - patient/CareTeam.rs
        - patient/Condition.rs
        - patient/Coverage.rs
        - patient/Device.rs
        - patient/DiagnosticReport.rs
        - patient/DocumentReference.rs
        - patient/Encounter.rs
        - patient/Goal.rs
        - patient/Immunization.rs
        - patient/Location.rs
        - patient/Medication.rs
        - patient/MedicationRequest.rs
        - patient/Observation.rs
        - patient/Organization.rs
        - patient/Patient.rs
        - patient/Practitioner.rs
        - patient/PractitionerRole.rs
        - patient/Procedure.rs
        - patient/Provenance.rs
        - patient/RelatedPerson.rs
        - patient/ServiceRequest.rs
        - user/AllergyIntolerance.rs
        - user/CarePlan.rs
        - user/CareTeam.rs
        - user/Condition.rs
        - user/Coverage.rs
        - user/Device.rs
        - user/DiagnosticReport.rs
        - user/DocumentReference.rs
        - user/Encounter.rs
        - user/Goal.rs
        - user/Immunization.rs
        - user/Location.rs
        - user/Medication.rs
        - user/MedicationRequest.rs
        - user/Observation.rs
        - user/Organization.rs
        - user/Patient.rs
        - user/Practitioner.rs
        - user/PractitionerRole.rs
        - user/Procedure.rs
        - user/Provenance.rs
        - user/RelatedPerson.rs
        - user/ServiceRequest.rs
        - system/AllergyIntolerance.rs
        - system/CarePlan.rs
        - system/CareTeam.rs
        - system/Condition.rs
        - system/Coverage.rs
        - system/Device.rs
        - system/DiagnosticReport.rs
        - system/DocumentReference.rs
        - system/Encounter.rs
        - system/Goal.rs
        - system/Immunization.rs
        - system/Location.rs
        - system/Medication.rs
        - system/MedicationRequest.rs
        - system/Observation.rs
        - system/Organization.rs
        - system/Patient.rs
        - system/Practitioner.rs
        - system/PractitionerRole.rs
        - system/Procedure.rs
        - system/Provenance.rs
        - system/RelatedPerson.rs
        - system/ServiceRequest.rs
  /Patient/{id}/$export:
    servers:
    - url: https://fhirmp.mmi.prod.fhir.ema-api.com/fhir/r4
      description: EMA Certified FHIR API
      variables:
        firm:
          default: fhirmp
          description: Your firm subdomain (e.g. fhirmp, auraderm). Find yours at https://mm-fhir-endpoint-display.prod.fhir.ema-api.com/
    get:
      tags:
      - Patient
      summary: 'GET: /Patient/{id}/$export'
      parameters:
      - name: id
        in: path
        description: The resource ID
        required: true
        style: simple
        schema:
          minimum: 1
          type: string
        example: '123'
      - name: _outputFormat
        in: query
        required: false
        schema:
          type: string
      - name: _since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            format: date-time
          - type: string
            format: date
      - name: _type
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
            application/fhir+xml:
              schema:
                $ref: '#/components/schemas/FHIR-XML-RESOURCE'
      security:
      - smartOnFhir:
        - openid
        - fhirUser
        - profile
        - launch/patient
        - offline_access
        - patient/AllergyIntolerance.rs
        - patient/CarePlan.rs
        - patient/CareTeam.rs
        - patient/Condition.rs
        - patient/Coverage.rs
        - patient/Device.rs
        - patient/DiagnosticReport.rs
        - patient/DocumentReference.rs
        - patient/Encounter.rs
        - patient/Goal.rs
        - patient/Immunization.rs
        - patient/Location.rs
        - patient/Medication.rs
        - patient/MedicationRequest.rs
        - patient/Observation.rs
        - patient/Organization.rs
        - patient/Patient.rs
        - patient/Practitioner.rs
        - patient/PractitionerRole.rs
        - patient/Procedure.rs
        - patient/Provenance.rs
        - patient/RelatedPerson.rs
        - patient/ServiceRequest.rs
        - user/AllergyIntolerance.rs
        - user/CarePlan.rs
        - user/CareTeam.rs
        - user/Condition.rs
        - user/Coverage.rs
        - user/Device.rs
        - user/DiagnosticReport.rs
        - user/DocumentReference.rs
        - user/Encounter.rs
        - user/Goal.rs
        - user/Immunization.rs
        - user/Location.rs
        - user/Medication.rs
        - user/MedicationRequest.rs
        - user/Observation.rs
        - user/Organization.rs
        - user/Patient.rs
        - user/Practitioner.rs
        - user/PractitionerRole.rs
        - user/Procedure.rs
        - user/Provenance.rs
        - user/RelatedPerson.rs
        - user/ServiceRequest.rs
        - system/AllergyIntolerance.rs
        - system/CarePlan.rs
        - system/CareTeam.rs
        - system/Condition.rs
        - system/Coverage.rs
        - system/Device.rs
        - system/DiagnosticReport.rs
        - system/DocumentReference.rs
        - system/Encounter.rs
        - system/Goal.rs
        - system/Immunization.rs
        - system/Location.rs
        - system/Medication.rs
        - system/MedicationRequest.rs
        - system/Observation.rs
        - system/Organization.rs
        - system/Patient.rs
        - system/Practitioner.rs
        - system/PractitionerRole.rs
        - system/Procedure.rs
        - system/Provenance.rs
        - system/RelatedPerson.rs
        - system/ServiceRequest.rs
  /Patient/{id}:
    servers:
    - url: https://fhirmp.mmi.prod.fhir.ema-api.com/fhir/r4
      description: EMA Certified FHIR API
      variables:
        firm:
          default: fhirmp
          description: Your firm subdomain (e.g. fhirmp, auraderm). Find yours at https://mm-fhir-endpoint-display.prod.fhir.ema-api.com/
    get:
      tags:
      - Patient
      summary: 'read-instance: Read Patient instance'
      parameters:
      - name: id
        in: path
        description: The resource ID
        required: true
        style: simple
        schema:
          minimum: 1
          type: string
        example: '123'
      responses:
        '200':
          description: Success
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
              example:
                resourceType: Patient
                id: 1.120182.1.17082675
                meta:
                  source: Organization/1.120182
                  profile:
                  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient
                extension:
                - url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-race
                  extension:
                  - url: ombCategory
                    valueCoding:
                      system: http://terminology.hl7.org/CodeSystem/v3-NullFlavor
                      code: UNK
                      display: Unknown
                  - url: text
                    valueString: Unknown
                - url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity
                  extension:
                  - url: text
                    valueString: Unspecified
                - url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex
                  valueCode: F
                - url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-sex
                  valueCode: '248152002'
                - url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-genderIdentity
                  valueCodeableConcept:
                    coding:
                    - system: http://terminology.hl7.org/CodeSystem/v3-NullFlavor
                      code: UNK
                      display: unknown
                identifier:
                - system: http://hl7.org/fhir/v2/0203/index.html#v2-0203-MR
                  value: MM0000000002
                - system: http://hl7.org/fhir/v2/0203/index.html#v2-0203-PT
                  value: 120182PAT000000002
                - system: http://hl7.org/fhir/v2/0203/index.html#v2-0203-PI
                  value: '17082675'
                active: true
                name:
                - family: Syrup
                  given:
                  - Mabel
                telecom:
                - system: email
                  value: mabel.syrup@example.com
                - system: phone
                  value: '9998887777'
                  use: mobile
                  rank: 1
                gender: female
                birthDate: '1991-06-14'
                address:
                - type: both
                  postalCode: '17033'
                - type: both
                  line:
                  - 1 Main St
                  city: Hershey
                  district: Dauphin County
                  state: PA
                  postalCode: '17033'
                  country: United_States_of_America
                maritalStatus:
                  coding:
                  - system: http://terminology.hl7.org/CodeSystem/v3-NullFlavor
                    code: UNK
                    display: Unknown
            application/fhir+xml:
              schema:
                $ref: '#/components/schemas/FHIR-XML-RESOURCE'
      security:
      - smartOnFhir:
        - openid
        - fhirUser
        - profile
        - launch/patient
        - offline_access
        - patient/AllergyIntolerance.rs
        - patient/CarePlan.rs
        - patient/CareTeam.rs
        - patient/Condition.rs
        - patient/Coverage.rs
        - patient/Device.rs
        - patient/DiagnosticReport.rs
        - patient/DocumentReference.rs
        - patient/Encounter.rs
        - patient/Goal.rs
        - patient/Immunization.rs
        - patient/Location.rs
        - patient/Medication.rs
        - patient/MedicationRequest.rs
        - patient/Observation.rs
        - patient/Organization.rs
        - patient/Patient.rs
        - patient/Practitioner.rs
        - patient/PractitionerRole.rs
        - patient/Procedure.rs
        - patient/Provenance.rs
        - patient/RelatedPerson.rs
        - patient/ServiceRequest.rs
        - user/AllergyIntolerance.rs
        - user/CarePlan.rs
        - user/CareTeam.rs
        - user/Condition.rs
        - user/Coverage.rs
        - user/Device.rs
        - user/DiagnosticReport.rs
        - user/DocumentReference.rs
        - user/Encounter.rs
        - user/Goal.rs
        - user/Immunization.rs
        - user/Location.rs
        - user/Medication.rs
        - user/MedicationRequest.rs
        - user/Observation.rs
        - user/Organization.rs
        - user/Patient.rs
        - user/Practitioner.rs
        - user/PractitionerRole.rs
        - user/Procedure.rs
        - user/Provenance.rs
        - user/RelatedPerson.rs
        - user/ServiceRequest.rs
        - system/AllergyIntolerance.rs
        - system/CarePlan.rs
        - system/CareTeam.rs
        - system/Condition.rs
        - system/Coverage.rs
        - system/Device.rs
        - system/DiagnosticReport.rs
        - system/DocumentReference.rs
        - system/Encounter.rs
        - system/Goal.rs
        - system/Immunization.rs
        - system/Location.rs
        - system/Medication.rs
        - system/MedicationRequest.rs
        - system/Observation.rs
        - system/Organization.rs
        - system/Patient.rs
        - system/Practitioner.rs
        - system/PractitionerRole.rs
        - system/Procedure.rs
        - system/Provenance.rs
        - system/RelatedPerson.rs
        - system/ServiceRequest.rs
  /Patient:
    servers:
    - url: https://fhirmp.mmi.prod.fhir.ema-api.com/fhir/r4
      description: EMA Certified FHIR API
      variables:
        firm:
          default: fhirmp
          description: Your firm subdomain (e.g. fhirmp, auraderm). Find yours at https://mm-fhir-endpoint-display.prod.fhir.ema-api.com/
    get:
      tags:
      - Patient
      summary: 'search-type: Search for Patient instances'
      description: This is a search type
      parameters:
      - name: _id
        in: query
        description: The ID of the resource
        required: false
        schema:
          type: string
      - name: active
        in: query
        description: Whether the patient record is active
        required: false
        schema:
          type: string
      - name: address
        in: query
        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
        required: false
        schema:
          type: string
      - name: address-city
        in: query
        description: A city specified in an address
        required: false
        schema:
          type: string
      - name: address-country
        in: query
        description: A country specified in an address
        required: false
        schema:
          type: string
      - name: address-postalcode
        in: query
        description: A postalCode specified in an address
        required: false
        schema:
          type: string
      - name: address-state
        in: query
        description: A state specified in an address
        required: false
        schema:
          type: string
      - name: address-use
        in: query
        description: A use code specified in an address
        required: false
        schema:
          type: string
      - name: birthdate
        in: query
        description: The patient's date of birth
        required: false
        schema:
          anyOf:
          - type: string
            format: date-time
          - type: string
            format: date
      - name: deceased
        in: query
        description: This patient has been marked as deceased, or as a death date entered
        required: false
        schema:
          type: string
      - name: email
        in: query
        description: A value in an email contact
        required: false
        schema:
          type: string
      - name: family
        in: query
        description: A portion of the family name of the patient
        required: false
        schema:
          type: string
      - name: gender
        in: query
        description: Gender of the patient
        required: false
        schema:
          type: string
      - name: general-practitioner
        in: query
        description: Patient's nominated general practitioner, not the organization that manages the record
        required: false
        schema:
          type: string
      - name: given
        in: query
        description: A portion of the given name of the patient
        required: false
        schema:
          type: string
      - name: identifier
        in: query
        description: A patient identifier
        required: false
        schema:
          type: string
      - name: language
        in: query
        description: Language code (irrespective of use value)
        required: false
        schema:
          type: string
      - name: link
        in: query
        description: All patients linked to the given patient
        required: false
        schema:
          type: string
      - name: link-type
        in: query
        required: false
        schema:
          type: string
      - name: name
        in: query
        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
        required: false
        schema:
          type: string
      - name: phone
        in: query
        description: A value in a phone contact
        required: false
        schema:
          type: string
      - name: telecom
        in: query
        description: The value in any kind of telecom details of the patient
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
              example:
                resourceType: Bundle
                type: searchset
                total: 1
                link:
                - relation: self
                  url: https://fhirmp.mmi.prod.fhir.ema-api.com/fhir/r4/Patient?family=Syrup
                entry:
                - fullUrl: https://fhirmp.mmi.prod.fhir.ema-api.com/fhir/r4/Patient/1.120182.1.17082675
                  resource:
                    resourceType: Patient
                    id: 1.120182.1.17082675
                    meta:
                      source: Organization/1.120182
                      profile:
                      - http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient
                    extension:
                    - url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-race
                      extension:
                      - url: ombCategory
                        valueCoding:
                          system: http://terminology.hl7.org/CodeSystem/v3-NullFlavor
                          code: UNK
                          display: Unknown
                      - url: text
                        valueString: Unknown
                    - url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity
                      extension:
                      - url: text
                        valueString: Unspecified
                    - url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex
                      valueCode: F
                    - url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-sex
                      valueCode: '248152002'
                    - url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-genderIdentity
                      valueCodeableConcept:
                        coding:
                        - system: http://terminology.hl7.org/CodeSystem/v3-NullFlavor
                          code: UNK
                          display: unknown
                    identifier:
                    - system: http://hl7.org/fhir/v2/0203/index.html#v2-0203-MR
                      value: MM0000000002
                    - system: http://hl7.org/fhir/v2/0203/index.html#v2-0203-PT
                      value: 120182PAT000000002
                    - system: http://hl7.org/fhir/v2/0203/index.html#v2-0203-PI
                      value: '17082675'
                    active: true
                    name:
                    - family: Syrup
                      given:
                      - Mabel
                    telecom:
                    - system: email
                      value: mabel.syrup@example.com
                    - system: phone
                      value: '9998887777'
                      use: mobile
                      rank: 1
                    gender: female
                    birthDate: '1991-06-14'
                    address:
                    - type: both
                      postalCode: '17033'
                    - type: both
                      line:
                      - 1 Main St
                      city: Hershey
                      district: Dauphin County
                      state: PA
                      postalCode: '17033'
                      country: United_States_of_America
                    maritalStatus:
                      coding:
                      - system: http://terminology.hl7.org/CodeSystem/v3-NullFlavor
                        code: UNK
                        display: Unknown
            application/fhir+xml:
              schema:
                $ref: '#/components/schemas/FHIR-XML-RESOURCE'
      security:
      - smartOnFhir:
        - openid
        - fhirUser
        - profile
        - launch/patient
        - offline_access
        - patient/AllergyIntolerance.rs
        - patient/CarePlan.rs
        - patient/CareTeam.rs
        - patient/Condition.rs
        - patient/Coverage.rs
        - patient/Device.rs
        - patient/DiagnosticReport.rs
        - patient/DocumentReference.rs
        - patient/Encounter.rs
        - patient/Goal.rs
        - patient/Immunization.rs
        - patient/Location.rs
        - patient/Medication.rs
        - patient/MedicationRequest.rs
        - patient/Observation.rs
        - patient/Organization.rs
        - patient/Patient.rs
        - patient/Practitioner.rs
        - patient/PractitionerRole.rs
        - patient/Procedure.rs
        - patient/Provenance.rs
        - patient/RelatedPerson.rs
        - patient/ServiceRequest.rs
        - user/AllergyIntolerance.rs
        - user/CarePlan.rs
        - user/CareTeam.rs
        - user/Condition.rs
        - user/Coverage.rs
        - user/Device.rs
        - user/DiagnosticReport.rs
        - user/DocumentReference.rs
        - user/Encounter.rs
        - user/Goal.rs
        - user/Immunization.rs
        - user/Location.rs
        - user/Medication.rs
        - user/MedicationRequest.rs
        - user/Observation.rs
        - user/Organization.rs
        - user/Patient.rs
        - user/Practitioner.rs
        - user/PractitionerRole.rs
        - user/Procedure.rs
        - user/Provenance.rs
        - user/RelatedPerson.rs
        - user/ServiceRequest.rs
        - system/AllergyIntolerance.rs
        - system/CarePlan.rs
        - system/CareTeam.rs
        - system/Condition.rs
        - system/Coverage.rs
        - system/Device.rs
        - system/DiagnosticReport.rs
        - system/DocumentReference.rs
        - system/Encounter.rs
        - system/Goal.rs
        - system/Immunization.rs
        - system/Location.rs
        - system/Medication.rs
        - system/MedicationRequest.rs
        - system/Observation.rs
        - system/Organization.rs
        - system/Patient.rs
        - system/Practitioner.rs
        - system/PractitionerRole.rs
        - system/Procedure.rs
        - system/Provenance.rs
        - system/RelatedPerson.rs
        - system/ServiceRequest.rs
  /fhir/v2/Patient/{id}:
    servers:
    - url: https://stage.ema-api.com/ema-dev/firm/apiportal/ema
    get:
      tags:
      - Patient
      summary: 'read-instance: Read Patient instance'
      parameters:
      - name: id
        in: path
        description: The resource ID
        required: true
        style: simple
        schema:
          minimum: 1
          type: string
        example: '123'
      - name: Content-flag
        in: header
        required: false
        description: Optional header. `Referral` adds Referral Contact and Referral Source information to the Patient payload.
        schema:
          type: string
          enum:
          - Referral
      responses:
        '200':
          description: Success
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
              example:
                resourceType: Patient
                id: '450858'
                meta:
                  lastUpdated: '2026-06-25T15:55:00.000+00:00'
                extension:
                - url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity
                  extension:
                  - url: text
                    valueString: Unspecified
                identifier:
                - system: http://www.hl7.org/fhir/v2/0203/index.html#v2-0203-MR
                  value: MM0000000059
                - system: PMS
                  value: 112416PAT000000057
                active: true
                name:
                - family: Syrup
                  given:
                  - Mabel
                telecom:
                - system: email
                  value: mabel.syrup@modmed.com
                - system: phone
                  value: '9998887777'
                  use: mobile
                  rank: 1
                gender: female
                birthDate: '1980-01-01'
                deceasedBoolean: false
                address:
                - use: home
                  type: both
                  line:
                  - 123 MAIN ST
                  city: BOCA RATON
                  state: FL
                  postalCode: '33431'
                  country: United States of America
                maritalStatus:
                  coding:
                  - system: http://www.hl7.org/fhir/v2/0002
                    code: T
                    display: Unreported
                  text: Unreported
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/ServerError'
      description: Retrieve a single Patient resource by its MMI id.
      security:
      - BearerAuth: []
        ApiKeyAuth: []
    put:
      tags:
      - Patient
      summary: Updates Patient Resource
      parameters:
      - name: id
        in: path
        description: The resource ID
        required: true
        style: simple
        schema:
          minimum: 1
          type: string
        example: '123'
      requestBody:
        required: true
        content:
          application/fhir+json:
            schema:
              $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
            example:
              resourceType: Patient
              id: '50181'
              extension:
              - url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-race
                extension:
                - url: ombCategory
                  valueCoding:
                    system: http://terminology.hl7.org/CodeSystem/v3-NullFlavor
                    code: UNK
                    display: Unknown
                - url: text
                  valueString: Unknown
              - url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity
                extension:
                - url: text
                  valueString: Unspecified
              identifier:
              - system: PMS
                value: EXAMPLE-ID
              - system: http://hl7.org/fhir/sid/us-ssn
                value: EXAMPLE-ID
              - system: http://www.hl7.org/fhir/v2/0203/index.html#v2-0203-MR
                value: EXAMPLE-ID
              active: true
              name:
              - family: Sample
                given:
                - Test
              telecom:
              - system: email
                value: test@example.com
              - system: phone
                value: 555-555-0100
                use: home
                rank: 1
              gender: male
              birthDate: '1980-01-01'
              deceasedBoolean: false
              address:
              - use: home
                type: both
                line:
                - 123 Example St
                city: Anytown
                state: FL
                postalCode: '00000'
                country: Chile
              maritalStatus:
                coding:
                - system: http://www.hl7.org/fhir/v2/0002
                  code: R
                  display: Registered Domestic Partner
                text: Registered Domestic Partner
              contact:
              - relationship:
                - coding:
                  - system: http://www.hl7.org/fhir/v2/0131
                    code: C
                    display: Emergency Contact
                  text: Emergency Contact
                name:
                  given:
                  - Test
                telecom:
                - system: phone
                  value: 555-555-0100
              generalPractitioner:
              - identifier:
                  type:
                    coding:
                    - system: http://hl7.org/fhir/ValueSet/encounter-participant-type
                      code: REF
                      display: referrer
                    text: referrer
                  system: NPI
                  value: EXAMPLE-ID
                display: Example GeneralPractitioner
      responses:
        '200':
          description: Updated
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
              example:
                resourceType: Patient
                id: '375390'
                meta:
                  lastUpdated: '2025-09-23T14:51:45.000+00:00'
                extension:
                - url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity
                  extension:
                  - url: text
                    valueString: Unspecified
                identifier:
                - system: http://www.hl7.org/fhir/v2/0203/index.html#v2-0203-MR
                  value: MM0000000002
                - system: PMS
                  value: 112416PAT000000002
                active: true
                name:
                - family: Test
                  given:
                  - Female
                gender: male
                birthDate: '2000-09-09'
                deceasedBoolean: false
                maritalStatus:
                  coding:
                  - system: http://www.hl7.org/fhir/v2/0002
                    code: T
                    display: Unreported
                  text: Unreported
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/Serve

# --- truncated at 32 KB (49 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/modernizing-medicine/refs/heads/main/openapi/modernizing-medicine-patient-api-openapi.yml