ModMed Insurance API

openapi: 3.2.0
info:
  title: EMA Proprietary Insurance 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: Insurance
  description: Insurance Details
paths:
  /fhir/v2/Coverage/{id}:
    get:
      tags:
      - Insurance
      summary: 'Retrieve Coverage details for an ID (Note: this is the specific coverage ID, not the Patient ID) In order to get this ID, you’d want to do a Coverage search with the ‘patient=value’ parameter. '
      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: Coverage
                id: '286892'
                meta:
                  lastUpdated: '2026-06-25T15:51:07.000+00:00'
                identifier:
                - system: payerId
                  value: '60054'
                status: active
                type:
                  coding:
                  - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/insurance-policy-type
                    code: EPO
                    display: EPO
                  text: EPO
                policyHolder:
                  display: Syrup, Mabel
                beneficiary:
                  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
                relationship:
                  coding:
                  - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/insured-relationship
                    code: SEL
                    display: Self
                  text: Self
                payor:
                - reference: Organization/pay|1388
                  display: Aetna Health Plans
                - reference: InsurancePlan/125
                  display: Aetna Plan A
                class:
                - type:
                    coding:
                    - system: https://www.hl7.org/fhir/codesystem-coverage-class.html#coverage-class-plan
                      code: plan
                      display: Plan
                    text: Plan
                  value: '5555555'
                  name: Aetna Plan A
                - type:
                    coding:
                    - system: https://www.hl7.org/fhir/codesystem-coverage-class.html#coverage-class-group
                      code: group
                      display: Group
                    text: Group
                  value: '44444444'
                order: 1
        '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:
      - Insurance
      summary: Updates Coverage 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 Coverage information 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/Coverage:
    get:
      tags:
      - Insurance
      summary: Retrieve Coverage resources meeting 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 100
        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: order
        in: query
        description: 'The order of the insurance policy, it can be 1= Primary , 2= Secondary 3 = Tertiary '
        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 unique Patient Identifier
        required: false
        schema:
          type: string
      - name: reconciliationId
        in: query
        description: Reconciliation Id Received from  a successful Coverage CREATE call
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
              example:
                resourceType: Bundle
                id: 09a08116-0daf-4fb1-9c88-833faff9bd17
                meta:
                  lastUpdated: '2026-06-25T16:01:25.642+00:00'
                type: searchset
                total: 1
                link:
                - relation: self
                  url: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Coverage?patient=450858&_count=3
                - relation: next
                  url: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Coverage?patient=450858&_count=3&page=2
                entry:
                - fullUrl: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Coverage/286892
                  resource:
                    resourceType: Coverage
                    id: '286892'
                    meta:
                      lastUpdated: '2026-06-25T15:51:07.000+00:00'
                    identifier:
                    - system: payerId
                      value: '60054'
                    status: active
                    type:
                      coding:
                      - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/insurance-policy-type
                        code: EPO
                        display: EPO
                      text: EPO
                    policyHolder:
                      display: Syrup, Mabel
                    beneficiary:
                      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
                    relationship:
                      coding:
                      - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/insured-relationship
                        code: SEL
                        display: Self
                      text: Self
                    payor:
                    - reference: Organization/pay|1388
                      display: Aetna Health Plans
                    - reference: InsurancePlan/125
                      display: Aetna Plan A
                    class:
                    - type:
                        coding:
                        - system: https://www.hl7.org/fhir/codesystem-coverage-class.html#coverage-class-plan
                          code: plan
                          display: Plan
                        text: Plan
                      value: '5555555'
                      name: Aetna Plan A
                    - type:
                        coding:
                        - system: https://www.hl7.org/fhir/codesystem-coverage-class.html#coverage-class-group
                          code: group
                          display: Group
                        text: Group
                      value: '44444444'
                    order: 1
        '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:
      - Insurance
      summary: Creates Coverage Resource
      requestBody:
        required: true
        content:
          application/fhir+json:
            schema:
              $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
            example:
              resourceType: Coverage
              status: active
              identifier:
              - system: PolicyHolderFirst
                value: EXAMPLE-ID
              - system: PolicyHolderLast
                value: EXAMPLE-ID
              - system: PolicyHolderMiddle
                value: EXAMPLE-ID
              - system: PolicyHolderSuffix
                value: EXAMPLE-ID
              - system: PolicyHolderDOB
                value: EXAMPLE-ID
              - system: PolicyHolderBirthSex
                value: EXAMPLE-ID
              - system: PolicyHolderAddress1
                value: EXAMPLE-ID
              - system: PolicyHolderAddress2
                value: EXAMPLE-ID
              - system: PolicyHolderAddressCity
                value: EXAMPLE-ID
              - system: PolicyHolderAddressState
                value: EXAMPLE-ID
              - system: PolicyHolderAddressZipCode
                value: EXAMPLE-ID
              - system: PolicyHolderPhoneHome
                value: EXAMPLE-ID
              - system: PolicyHolderPhoneMobile
                value: EXAMPLE-ID
              - system: PolicyHolderPhoneWork
                value: EXAMPLE-ID
              - system: InsuranceCardFrontUrl
                value: EXAMPLE-ID
              - system: InsuranceCardBackUrl
                value: EXAMPLE-ID
              type:
                coding:
                - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/insurance-policy-type
                  code: EPO
                  display: EPO
                text: EPO
              beneficiary:
                reference: Patient/20997614
                display: Test Sample
              relationship:
                coding:
                - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/insured-relationship
                  code: Other
                  display: Other
                text: Other
              period:
                start: '2022-01-01'
                end: '2023-01-01'
              payor:
              - reference: Organization/pay|7225
              - reference: InsurancePlan/626
              class:
              - type:
                  coding:
                  - system: https://www.hl7.org/fhir/codesystem-coverage-class.html#coverage-class-plan
                    code: plan
                    display: Plan
                  text: Plan
                value: EXAMPLE-ID
                name: MikeTestInsurancePlan
              - type:
                  coding:
                  - system: https://www.hl7.org/fhir/codesystem-coverage-class.html#coverage-class-group
                    code: group
                    display: Group
                  text: Group
                value: EXAMPLE-ID
              order: 1
              costToBeneficiary:
              - type:
                  coding:
                  - system: hhttps://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/cost-to-beneficiary-type
                    code: COPAY_AMOUNT
                valueMoney:
                  value: 50
                  currency: USD
              - type:
                  coding:
                  - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/cost-to-beneficiary-type
                    code: COINSURANCE_PERCENTAGE
                valueQuantity:
                  value: 20
              - type:
                  coding:
                  - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/cost-to-beneficiary-type
                    code: DEDUCTIBLE
                valueMoney:
                  value: 1500
                  currency: USD
              - type:
                  coding:
                  - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/cost-to-beneficiary-type
                    code: OUT_OF_POCKET
                valueMoney:
                  value: 500
                  currency: USD
              - type:
                  coding:
                  - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/cost-to-beneficiary-type
                    code: REMAINING_DEDUCTIBLE
                valueMoney:
                  value: 800
                  currency: USD
              - type:
                  coding:
                  - system: hhttps://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/cost-to-beneficiary-type
                    code: REMAINING_OUT_OF_POCKET
                valueMoney:
                  value: 100
                  currency: USD
      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: Coverage
                status: active
                identifier:
                - system: PolicyHolderFirst
                  value: EXAMPLE-ID
                - system: PolicyHolderLast
                  value: EXAMPLE-ID
                - system: PolicyHolderMiddle
                  value: EXAMPLE-ID
                - system: PolicyHolderSuffix
                  value: EXAMPLE-ID
                - system: PolicyHolderDOB
                  value: EXAMPLE-ID
                - system: PolicyHolderBirthSex
                  value: EXAMPLE-ID
                - system: PolicyHolderAddress1
                  value: EXAMPLE-ID
                - system: PolicyHolderAddress2
                  value: EXAMPLE-ID
                - system: PolicyHolderAddressCity
                  value: EXAMPLE-ID
                - system: PolicyHolderAddressState
                  value: EXAMPLE-ID
                - system: PolicyHolderAddressZipCode
                  value: EXAMPLE-ID
                - system: PolicyHolderPhoneHome
                  value: EXAMPLE-ID
                - system: PolicyHolderPhoneMobile
                  value: EXAMPLE-ID
                - system: PolicyHolderPhoneWork
                  value: EXAMPLE-ID
                - system: InsuranceCardFrontUrl
                  value: EXAMPLE-ID
                - system: InsuranceCardBackUrl
                  value: EXAMPLE-ID
                type:
                  coding:
                  - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/insurance-policy-type
                    code: EPO
                    display: EPO
                  text: EPO
                beneficiary:
                  reference: Patient/20997614
                  display: Test Sample
                relationship:
                  coding:
                  - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/insured-relationship
                    code: Other
                    display: Other
                  text: Other
                period:
                  start: '2022-01-01'
                  end: '2023-01-01'
                payor:
                - reference: Organization/pay|7225
                - reference: InsurancePlan/626
                class:
                - type:
                    coding:
                    - system: https://www.hl7.org/fhir/codesystem-coverage-class.html#coverage-class-plan
                      code: plan
                      display: Plan
                    text: Plan
                  value: EXAMPLE-ID
                  name: MikeTestInsurancePlan
                - type:
                    coding:
                    - system: https://www.hl7.org/fhir/codesystem-coverage-class.html#coverage-class-group
                      code: group
                      display: Group
                    text: Group
                  value: EXAMPLE-ID
                order: 1
                costToBeneficiary:
                - type:
                    coding:
                    - system: hhttps://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/cost-to-beneficiary-type
                      code: COPAY_AMOUNT
                  valueMoney:
                    value: 50
                    currency: USD
                - type:
                    coding:
                    - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/cost-to-beneficiary-type
                      code: COINSURANCE_PERCENTAGE
                  valueQuantity:
                    value: 20
                - type:
                    coding:
                    - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/cost-to-beneficiary-type
                      code: DEDUCTIBLE
                  valueMoney:
                    value: 1500
                    currency: USD
                - type:
                    coding:
                    - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/cost-to-beneficiary-type
                      code: OUT_OF_POCKET
                  valueMoney:
                    value: 500
                    currency: USD
                - type:
                    coding:
                    - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/cost-to-beneficiary-type
                      code: REMAINING_DEDUCTIBLE
                  valueMoney:
                    value: 800
                    currency: USD
                - type:
                    coding:
                    - system: hhttps://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/cost-to-beneficiary-type
                      code: REMAINING_OUT_OF_POCKET
                  valueMoney:
                    value: 100
                    currency: USD
        '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/InsurancePlan/{id}:
    get:
      tags:
      - Insurance
      summary: Retrieve InsurancePlan by 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: InsurancePlan
                id: '125'
                meta:
                  lastUpdated: '2026-06-25T15:45:09.000+00:00'
                status: active
                name: Aetna Plan A
                ownedBy:
                  reference: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Organization/pay%7C1388
                  display: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Organization/pay%7C1388
                plan:
                - type:
                    coding:
                    - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/insurance-policy-type
                      code: EPO
                      display: EPO
                    text: EPO
        '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/InsurancePlan:
    get:
      tags:
      - Insurance
      summary: Retrieve all InsurancePlan information for a Firm
      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 100
        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: owned-by
        in: query
        description: An organization of which this organization forms a part
        required: false
        schema:
          type: string
      - name: page
        in: query
        description: Page to be used for paginated search
        required: false
        schema:
          type: string
      - name: status
        in: query
        description: Is the Organization record active
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
              example:
                resourceType: Bundle
                id: 63023a33-b123-4dbe-aa55-a8cc2e930afc
                meta:
                  lastUpdated: '2026-06-25T14:56:05.344+00:00'
                type: searchset
                total: 2
                link:
                - relation: self
                  url: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/InsurancePlan?_count=2
                - relation: next
                  url: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/InsurancePlan?_count=2&page=2
                entry:
                - fullUrl: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/InsurancePlan/74
                  resource:
                    resourceType: InsurancePlan
                    id: '74'
                    meta:
                      lastUpdated: '2025-05-13T13:46:06.000+00:00'
                    status: active
                    name: PPO
                    ownedBy:
                      reference: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Organization/pay%7C1279
                      display: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Organization/pay%7C1279
                    plan:
                    - type:
                        coding:
                        - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/insurance-policy-type
                          code: PPO
                          display: PPO
                        text: PPO
                - fullUrl: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/InsurancePlan/75
                  resource:
                    resourceType: InsurancePlan
                    id: '75'
                    meta:
                      lastUpdated: '2025-05-13T13:48:09.000+00:00'
                    status: active
                    name: HMO
                    ownedBy:
                      reference: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Organization/pay%7C1300
                      display: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Organization/pay%7C1300
                    plan:
                    - type:
                        coding:
                        - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/insurance-policy-type
                          code: HMO
                          display: HMO
                        text: HMO
            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/Organization/{id}:
    get:
      tags:
      - Insurance
      summary: Retrieve information by ID
      parameters:
      - name: id
        in: path
        description: The resource ID append id with pay| or prov|
        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: Organization
                id: pay|1388
                meta:
                  lastUpdated: '2026-06-25T15:33:30.000+00:00'
                identifier:
                - system: payerId
                  value: '60054'
                active: true
                type:
                - coding:
                  - system: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/organization-type
                    code: pay
                    display: Payer
                  text: Payer
                name: Aetna Health Plans
        '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/Organization:
    get:
      tags:
      - Insurance
      summary: Search Organization 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 100
        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: active
        in: query
        description: Is the Organization record active
        required: false
        schema:
          type: string
      - name: identifier
        in: query
        description: Any identifier for the organization (not the accreditation issuer's identifier)
        required: false
        schema:
          type: string
      - name: name
        in: query
        description: A portion of the organization's name or alias
        required: false
        schema:
          type: string
      - name: page
        in: query
        description: Page to be used for paginated search
        required: false
        schema:
          type: string
      - name: type
        in: query
        description: A code for the type of organization use pay or prov
        required: true
        schema:
          type: string
          enum:
          - pay
          - prov
          default: pay
      responses:
        '200':
          description: Success
          content:
            application/fhir+json:
              schema:
                $ref: '#/components/schemas/FHIR-JSON-RESOURCE'
              example:
                resourceType: Bundle
                id: e0201f0a-74eb-49e8-a6c2-a78b92d7ae2f
                meta:
                  lastUpdated: '2026-06-25T15:07:08.232+00:00'
                type: searchset
                total: 0
                link:
                - relation: self
                  url: https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/Organization?type=prov&_count=2
        '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:
      - Insurance
      summary: Create Referring Institution
      requestBody:
        description: Send Valid FHIR Coverage information in JSON
        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: '#/comp

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