ModMed

ModMed Clinical Data/Clipboard API

Clinical Data/Clipboard details

GitHub OpenAPI

Documentation

📖
Documentation
https://portal.api.modmed.com/docs/ema-proprietary-api
📖
APIReference
https://portal.api.modmed.com/reference/getting-started-2
📖
Authentication
https://portal.api.modmed.com/reference/authentication-1
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/modernizing-medicine/refs/heads/main/rate-limits/modernizing-medicine-rate-limits.yml
📖
Documentation
https://portal.api.modmed.com/docs/register-to-become-a-modmed-certified-fhir-api-vendor
📖
APIReference
https://portal.api.modmed.com/reference/authentication-2
📖
Authentication
https://portal.api.modmed.com/reference/authentication-2

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/modernizing-medicine/refs/heads/main/openapi/modernizing-medicine-clinical-data-clipboard-api-openapi.yml

Other Resources

🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/modernizing-medicine/refs/heads/main/sandbox/modernizing-medicine-sandbox.yml
🔗
TermsOfService
https://www.modmed.com/proprietary-api-terms-of-use/
🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/modernizing-medicine/refs/heads/main/scopes/modernizing-medicine-scopes.yml
🔗
SignUp
https://fhir-vendor-dashboard.kube.prod.mmicse.com/
🔗
TermsOfService
https://www.modmed.com/public-api-terms-of-use/

OpenAPI Specification

modernizing-medicine-clinical-data-clipboard-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: EMA Proprietary Clinical Data/Clipboard API
  contact:
    email: ankit.srivastava@modmed.com
  version: 3.4.3_FINAL
  description: 'The EMA Proprietary FHIR API provides programmatic access to ModMed EMA clinical and practice-management data using FHIR R4-style resources under `/fhir/v2`.


    This documentation targets the **public sandbox** (`stage.ema-api.com`).


    **Authentication.** Two mechanisms are supported during the current migration: the **legacy OAuth2 `password` grant** (being sunset) and the **new OAuth2 `client_credentials`** flow (recommended for new integrations) — see the **Authentication** guide. Every API call also requires the `x-api-key` header.'
servers:
- url: https://stage.ema-api.com/ema-dev/firm/apiportal/ema
security:
- BearerAuth: []
  ApiKeyAuth: []
tags:
- name: Clinical Data/Clipboard
  description: Clinical Data/Clipboard details
paths:
  /fhir/v2/AllergyIntolerance/{id}:
    get:
      tags:
      - Clinical Data/Clipboard
      summary: Retrieve AllergyIntolerance details for an AllergyIntolerance ID
      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: AllergyIntolerance
                id: '16086'
                clinicalStatus:
                  coding:
                  - system: https://www.hl7.org/fhir/valueset-allergyintolerance-clinical.html
                    code: active
                    display: Active
                  text: Active
                code:
                  coding:
                  - system: RxNorm
                    code: '2670'
                    display: codeine
                  text: codeine
                patient:
                  reference: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Patient/450858
                  display: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Patient/450858
                onsetDateTime: '2026-06-25T15:53:26+00:00'
                recordedDate: '2026-06-25T15:53:26+00:00'
        '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'
    put:
      tags:
      - Clinical Data/Clipboard
      summary: Update AllergyIntolerance resource
      parameters:
      - name: id
        in: path
        description: The resource ID
        required: true
        style: simple
        schema:
          minimum: 1
          type: string
        example: '123'
      requestBody:
        description: Send Valid AllergyIntolerance attributes to be updated in JSON form
        content:
          application/fhir+json:
            schema:
              $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
        required: true
      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'
        '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'
  /fhir/v2/AllergyIntolerance:
    get:
      tags:
      - Clinical Data/Clipboard
      summary: Retrieve AllergyIntolerance resources by the specified search criteria
      parameters:
      - name: patient
        in: query
        description: Returns statements for a specific patient.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
              example:
                resourceType: Bundle
                id: 3232c8b4-d6d6-463d-8c74-f26c187cf9e3
                meta:
                  lastUpdated: '2026-06-25T16:49:26.678+00:00'
                type: searchset
                total: 1
                link:
                - relation: self
                  url: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/AllergyIntolerance?patient=450858&_count=2
                entry:
                - fullUrl: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/AllergyIntolerance/16086
                  resource:
                    resourceType: AllergyIntolerance
                    id: '16086'
                    clinicalStatus:
                      coding:
                      - system: https://www.hl7.org/fhir/valueset-allergyintolerance-clinical.html
                        code: active
                        display: Active
                      text: Active
                    code:
                      coding:
                      - system: RxNorm
                        code: '2670'
                        display: codeine
                      text: codeine
                    patient:
                      reference: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Patient/450858
                      display: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Patient/450858
                    onsetDateTime: '2026-06-25T15:53:26+00:00'
                    recordedDate: '2026-06-25T15:53:26+00:00'
        '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'
    post:
      tags:
      - Clinical Data/Clipboard
      summary: Create AllergyIntolerance resource
      requestBody:
        required: true
        content:
          application/fhir+json:
            schema:
              $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
            example:
              resourceType: AllergyIntolerance
              clinicalStatus:
                coding:
                - system: https://www.hl7.org/fhir/valueset-allergyintolerance-clinical.html
                  code: active
                  display: Active
                text: Active
              code:
                coding:
                - system: RxNorm
                  code: '219147'
                  display: Penecort
                text: Penecort
              patient:
                reference: Patient/5003
                display: Test Sample
              onsetDateTime: '1988-08-01T00:00:00+00:00'
              recordedDate: '2019-11-07T00:00:00+00:00'
              lastOccurrence: '2019-11-01T00:00:00+00:00'
              reaction:
              - substance:
                  coding:
                  - system: RxNorm
                    code: '219147'
                    display: Penecort
                  text: Penecort
                manifestation:
                - coding:
                  - system: SNOMED CT
                    code: '417516000'
                    display: Anaphylaxis
                  text: Anaphylaxis
                description: Anaphylaxis
                severity: severe
      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'
        '201':
          description: Created
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
              example:
                resourceType: AllergyIntolerance
                clinicalStatus:
                  coding:
                  - system: https://www.hl7.org/fhir/valueset-allergyintolerance-clinical.html
                    code: active
                    display: Active
                  text: Active
                code:
                  coding:
                  - system: RxNorm
                    code: '219147'
                    display: Penecort
                  text: Penecort
                patient:
                  reference: Patient/5003
                  display: Test Sample
                onsetDateTime: '1988-08-01T00:00:00+00:00'
                recordedDate: '2019-11-07T00:00:00+00:00'
                lastOccurrence: '2019-11-01T00:00:00+00:00'
                reaction:
                - substance:
                    coding:
                    - system: RxNorm
                      code: '219147'
                      display: Penecort
                    text: Penecort
                  manifestation:
                  - coding:
                    - system: SNOMED CT
                      code: '417516000'
                      display: Anaphylaxis
                    text: Anaphylaxis
                  description: Anaphylaxis
                  severity: severe
        '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'
      x-readme:
        explorer-enabled: false
  /fhir/v2/Condition/{id}:
    get:
      tags:
      - Clinical Data/Clipboard
      summary: Retrieve Condition details for an ID
      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: Condition
                id: '17295'
                meta:
                  lastUpdated: '2026-06-25T15:59:28.000+00:00'
                identifier:
                - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/condition-type
                  value: PROB
                - type:
                    coding:
                    - system: ICD10
                      code: L72.8
                      display: Other follicular cysts of the skin and subcutaneous tissue
                    - system: ICD9
                      code: '706.2'
                      display: Sebaceous cyst
                    text: Additional Codes
                clinicalStatus:
                  coding:
                  - system: http://hl7.org/fhir/ValueSet/condition-clinical
                    code: ACTIVE
                    display: Active
                  text: Active
                category:
                - coding:
                  - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/condition-category
                    code: DIAGNOSIS
                    display: Diagnosis
                  text: Diagnosis
                code:
                  coding:
                  - system: SNOMED CT
                    code: '201294000'
                    display: Follicular cysts of skin and subcutaneous tissue (disorder)
                  text: Follicular cysts of skin and subcutaneous tissue (disorder)
                subject:
                  reference: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Patient/450858
                  display: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Patient/450858
                onsetDateTime: '2026-06-25T11:55:00+00:00'
                recordedDate: '2026-06-25T15:55:00+00:00'
        '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'
    put:
      tags:
      - Clinical Data/Clipboard
      summary: Update Condition resource
      parameters:
      - name: id
        in: path
        description: The Condition ID
        required: true
        style: simple
        schema:
          minimum: 1
          type: string
        example: '123'
      requestBody:
        description: Send Valid Condition attributes to be updated in JSON form
        content:
          application/fhir+json:
            schema:
              $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
        required: true
      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'
        '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'
  /fhir/v2/Condition:
    get:
      tags:
      - Clinical Data/Clipboard
      summary: Retrieve Condition resources by the specified search criteria
      parameters:
      - name: patient
        in: query
        description: Returns statements for a specific patient.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
              example:
                resourceType: Bundle
                id: 8785e4d6-f7fd-4fa9-9e62-06e75922716c
                meta:
                  lastUpdated: '2026-06-25T16:49:26.407+00:00'
                type: searchset
                total: 2
                link:
                - relation: self
                  url: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Condition?patient=450858&_count=2
                - relation: next
                  url: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Condition?patient=450858&_count=2&page=2
                entry:
                - fullUrl: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Condition/17295
                  resource:
                    resourceType: Condition
                    id: '17295'
                    meta:
                      lastUpdated: '2026-06-25T15:59:28.000+00:00'
                    identifier:
                    - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/condition-type
                      value: PROB
                    - type:
                        coding:
                        - system: ICD10
                          code: L72.8
                          display: Other follicular cysts of the skin and subcutaneous tissue
                        - system: ICD9
                          code: '706.2'
                          display: Sebaceous cyst
                        text: Additional Codes
                    clinicalStatus:
                      coding:
                      - system: http://hl7.org/fhir/ValueSet/condition-clinical
                        code: ACTIVE
                        display: Active
                      text: Active
                    category:
                    - coding:
                      - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/condition-category
                        code: DIAGNOSIS
                        display: Diagnosis
                      text: Diagnosis
                    code:
                      coding:
                      - system: SNOMED CT
                        code: '201294000'
                        display: Follicular cysts of skin and subcutaneous tissue (disorder)
                      text: Follicular cysts of skin and subcutaneous tissue (disorder)
                    subject:
                      reference: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Patient/450858
                      display: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Patient/450858
                    onsetDateTime: '2026-06-25T11:55:00+00:00'
                    recordedDate: '2026-06-25T15:55:00+00:00'
                - fullUrl: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Condition/17296
                  resource:
                    resourceType: Condition
                    id: '17296'
                    meta:
                      lastUpdated: '2026-06-25T15:59:40.000+00:00'
                    identifier:
                    - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/condition-type
                      value: PROB
                    clinicalStatus:
                      coding:
                      - system: http://hl7.org/fhir/ValueSet/condition-clinical
                        code: ACTIVE
                        display: Active
                      text: Active
                    category:
                    - coding:
                      - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/condition-category
                        code: PROBLEM
                        display: Problem
                      text: Problem
                    code:
                      coding:
                      - system: SNOMED CT
                        code: '195967001'
                        display: Asthma (disorder)
                      text: Asthma (disorder)
                    subject:
                      reference: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Patient/450858
                      display: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Patient/450858
                    onsetDateTime: '2026-06-25T15:59:40+00:00'
        '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'
    post:
      tags:
      - Clinical Data/Clipboard
      summary: Create Condition resource
      requestBody:
        required: true
        content:
          application/fhir+json:
            schema:
              $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
            example:
              resourceType: Condition
              clinicalStatus:
                coding:
                - system: http://terminology.hl7.org/CodeSystem/condition-clinical
                  code: active
                  display: Active
              category:
              - coding:
                - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/condition-category
                  code: CONDITION
                  display: Condition
              code:
                coding:
                - system: SNOMED CT
                  code: '161501007'
                  display: History of hypertension (situation)
              subject:
                reference: Patient/450858
                display: Patient/450858
              recordedDate: '2026-06-11'
      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'
        '201':
          description: Created
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
              example:
                resourceType: Condition
                clinicalStatus:
                  coding:
                  - system: http://terminology.hl7.org/CodeSystem/condition-clinical
                    code: active
                    display: Active
                category:
                - coding:
                  - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/condition-category
                    code: CONDITION
                    display: Condition
                code:
                  coding:
                  - system: SNOMED CT
                    code: '161501007'
                    display: History of hypertension (situation)
                subject:
                  reference: Patient/450858
                  display: Patient/450858
                recordedDate: '2026-06-11'
        '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'
      x-readme:
        explorer-enabled: false
  /fhir/v2/DiagnosticReport/{id}:
    get:
      tags:
      - Clinical Data/Clipboard
      summary: Retrieve DiagnosticReport for an ID
      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: DiagnosticReport
                id: 1.112213.8.1.2258586
                meta:
                  lastUpdated: '2023-03-16T19:44:26.132+00:00'
                  source: Organization/1.112213
                status: final
                category:
                - coding:
                  - system: http://terminology.hl7.org/CodeSystem/v2-0074
                    code: LAB
                    display: Laboratory
                  text: Laboratory
                code:
                  coding:
                  - system: http://loinc.org
                    code: 14363-6
                  text: Gram Stn Snv
                subject:
                  reference: Patient/1.112213.1.19041015
                  type: Patient
                encounter:
                  reference: Encounter/1.112213.10.17761589
                  type: Encounter
                _effectiveDateTime:
                  extension:
                  - url: http://hl7.org/fhir/StructureDefinition/data-absent-reason
                    valueCode: unknown
                issued: '2023-03-16T18:52:06.000+00:00'
                performer:
                - reference: Practitioner/1.112213.2.5352
                  type: Practitioner
                - reference: Organization/1.112213
                  type: Organization
                result:
                - reference: Observation/1.112213.17.3.3285894
                  type: Observation
        '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'
  /fhir/v2/DiagnosticReport:
    get:
      tags:
      - Clinical Data/Clipboard
      summary: Search DiagnosticReport by certain parameters
      parameters:
      - name: _count
        in: query
        description: Number of records to use as the page size for paginated search. The maximum page size for this Resource is 50
        required: false
        schema:
          type: string
      - name: _lastUpdated
        in: query
        description: This is an Optional Date in the format _lastUpdated=gtDATE, _lastUpdated=eqDATE and _lastUpdated=leDATE in the format yyyy-mm-dd
        required: false
        schema:
          type: string
          format: date
      - name: encounter
        in: query
        description: An encounter in which this request is made
        required: false
        schema:
          type: string
      - name: page
        in: query
        description: Page to be used for paginated search
        required: false
        schema:
          type: string
      - name: patient
        in: query
        description: Search by subject - a patient
        required: false
        schema:
          type: string
      - name: requisition
        in: query
        description: Composite Request ID
        required: false
        schema:
          type: string
      - name: type
        in: query
        description: Diagnostic Report Type Search Parameter.
        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'
        '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'
  /fhir/v2/FamilyMemberHistory/{id}:
    get:
      tags:
      - Clinical Data/Clipboard
      summary: Retrieve FamilyMemberHistory details for an ID
      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: FamilyMemberHistory
                id: '612'
                status: partial
                patient:
                  reference: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Patient/450858
                  display: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Patient/450858
                date: '2026-06-25T15:54:28+00:00'
                relationship:
                  coding:
                  - system: SNOMED CT
                    code: '66839005'
                    display: FATHER
                  text: FATHER
                condition:
                - code:
                    coding:
                    - system: SNOMED CT
                      code: '429236009'
                      display: Family history of malignant neoplasm of liver (situation)
                    text: Family history of malignant neoplasm of liver (situation)
        '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'
  /fhir/v2/FamilyMemberHistory:
    get:
      tags:
      - Clinical Data/Clipboard
      summary: Retrieve FamilyMemberHistory resources by the specified search criteria
      parameters:
      - name: _count
        in: query
        description: Number of records to use as the page size for paginated search. The maximum page size for this Resource is 50
        required: false
        schema:
          type: string
      - name: page
        in: query
        description: Page to be used for paginated search
        required: false
        schema:
          type: string
      - name: patient
        in: query
        description: The identity of a subject to list family member history items for
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
              example:
                resourceType: Bundle
                id: 4d1c74bb-83a2-4905-92a2-a39033bf6f35
                meta:
                  lastUpdated: '2026-06-25T16:49:27.492+00:00'
                type: searchset
                total: 1
                link:
                - relation: self
                  url: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/FamilyMemberHistory?patient=450858&_count=2
                - relation: next
                  url: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/FamilyMemberHistory?patient=450858&_count=2&page=2
                entry:
                - fullUrl: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/FamilyMemberHistory/612
                  resource:
                    resourceType: FamilyMemberHistory
                    id: '612'
                    status: partial
                    patient:
                      reference: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Patient/450858
                      display: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Patient/450858
                    date: '2026-06-25T15:54:28+00:00'
                    relationship:
                      coding:
                      - system: SNOMED CT
                        code: '66839005'
                        display: FATHER
                      text: FATHER
                    condition:
                    - code:
                        coding:
                        - system: SNOMED CT
                          code: '429236009'
                  

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