openapi: 3.1.0
info:
  title: Humana FHIR Clinical API
  description: Minimal OpenAPI description for Humana's FHIR R4 / US Core STU3 patient access APIs covering common clinical, medication, and coverage resources. Each endpoint returns a FHIR Bundle (searchset) of the named resource type. Generated from public documentation; verify before production use.
  version: R4
  contact:
    name: Humana Developer Portal
    url: https://developers.humana.com/
  x-generated-from: https://developers.humana.com/apis/allergyintolerance-api/doc
  x-generated-by: claude-crawl-2026-05-08
servers:
- url: https://fhir.humana.com/api
  description: Humana FHIR production
- url: https://sandbox-fhir.humana.com/api
  description: Humana FHIR sandbox
security:
- bearerAuth: []
tags:
- name: Clinical
  description: Clinical FHIR resources
paths:
  /AllergyIntolerance:
    get:
      operationId: searchAllergyIntolerance
      summary: Search AllergyIntolerance
      tags:
      - Clinical
      parameters:
      - name: patient
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: FHIR Bundle
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Bundle'
  /CarePlan:
    get:
      operationId: searchCarePlan
      summary: Search CarePlan
      tags:
      - Clinical
      parameters:
      - name: patient
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: FHIR Bundle
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Bundle'
  /CareTeam:
    get:
      operationId: searchCareTeam
      summary: Search CareTeam
      tags:
      - Clinical
      parameters:
      - name: patient
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: FHIR Bundle
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Bundle'
  /Condition:
    get:
      operationId: searchCondition
      summary: Search Condition
      tags:
      - Clinical
      parameters:
      - name: patient
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: FHIR Bundle
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Bundle'
  /Goal:
    get:
      operationId: searchGoal
      summary: Search Goal
      tags:
      - Clinical
      parameters:
      - name: patient
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: FHIR Bundle
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Bundle'
  /Immunization:
    get:
      operationId: searchImmunization
      summary: Search Immunization
      tags:
      - Clinical
      parameters:
      - name: patient
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: FHIR Bundle
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Bundle'
  /Observation:
    get:
      operationId: searchObservation
      summary: Search Observation
      tags:
      - Clinical
      parameters:
      - name: patient
        in: query
        required: true
        schema:
          type: string
      - name: category
        in: query
        schema:
          type: string
      responses:
        '200':
          description: FHIR Bundle
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Bundle'
  /Procedure:
    get:
      operationId: searchProcedure
      summary: Search Procedure
      tags:
      - Clinical
      parameters:
      - name: patient
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: FHIR Bundle
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Bundle'
components:
  schemas:
    Bundle:
      type: object
      properties:
        resourceType:
          type: string
          const: Bundle
        type:
          type: string
        total:
          type: integer
        entry:
          type: array
          items:
            type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer