AmeriHealth Caritas · Capability

AmeriHealth Caritas Patient Access FHIR

Naftiko capability wrapping the AmeriHealth Caritas Patient Access FHIR R4 API. Read-only access to a member's clinical, demographic, encounter, immunization, observation, condition, and care plan resources, exposed both as a REST adapter and an MCP tool surface suitable for governed AI agents. Requires a SMART on FHIR / OAuth 2.0 bearer token bound to a single patient context.

AmeriHealth Caritas Patient Access FHIR is a Naftiko capability published by AmeriHealth Caritas, one of 4 capabilities the APIs.io network indexes for this provider. It bundles 7 operations across the GET method.

The capability includes 7 read-only operations. Lead operation: Read Patient by id. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include AmeriHealth Caritas, Patient Access, FHIR, SMART On FHIR, and Medicaid.

Run with Naftiko AmeriHealth CaritasPatient AccessFHIRSMART On FHIRMedicaid

What You Can Do

GET
Readpatient — Read patient by id
/v1/patient
GET
Searchallergies — Search AllergyIntolerance
/v1/allergies
GET
Searchconditions — Search Condition
/v1/conditions
GET
Searchencounters — Search Encounter
/v1/encounters
GET
Searchobservations — Search Observation
/v1/observations
GET
Searchimmunizations — Search Immunization
/v1/immunizations
GET
Searchprocedures — Search Procedure
/v1/procedures

MCP Tools

read-patient

Read Patient by id

read-only idempotent
search-allergy-intolerance

Search AllergyIntolerance for a patient

read-only idempotent
search-condition

Search Condition for a patient

read-only idempotent
search-encounter

Search Encounter for a patient

read-only idempotent
search-observation

Search Observation for a patient

read-only idempotent
search-immunization

Search Immunization for a patient

read-only idempotent
search-procedure

Search Procedure for a patient

read-only idempotent

Capability Spec

amerihealth-caritas-patient-access.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: AmeriHealth Caritas Patient Access FHIR
  description: >-
    Naftiko capability wrapping the AmeriHealth Caritas Patient Access
    FHIR R4 API. Read-only access to a member's clinical, demographic,
    encounter, immunization, observation, condition, and care plan
    resources, exposed both as a REST adapter and an MCP tool surface
    suitable for governed AI agents. Requires a SMART on FHIR / OAuth
    2.0 bearer token bound to a single patient context.
  tags:
    - AmeriHealth Caritas
    - Patient Access
    - FHIR
    - SMART On FHIR
    - Medicaid
  created: '2026-05-23'
  modified: '2026-05-23'
binds:
  - namespace: env
    keys:
      AHC_PATIENT_BEARER_TOKEN: AHC_PATIENT_BEARER_TOKEN
      AHC_PLAN_CODE: AHC_PLAN_CODE
capability:
  consumes:
    - type: http
      namespace: ahc-patient-access
      baseUri: https://api-ext.amerihealthcaritas.com/0500/patient-api
      description: >-
        AmeriHealth Caritas Patient Access FHIR R4 endpoint. Default
        base is the 0500 plan code; substitute the appropriate plan
        code (0100, 0500, 0900, 2400, 2600) for the member's plan.
      resources:
        - name: Patient
          path: /Patient/{id}
          operations:
            - name: readPatient
              method: GET
              description: Read a Patient resource by id
              outputRawFormat: json
              inputParameters:
                - name: id
                  in: path
                  type: string
                  required: true
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: AllergyIntolerance
          path: /AllergyIntolerance
          operations:
            - name: searchAllergyIntolerance
              method: GET
              description: Search AllergyIntolerance for a patient
              outputRawFormat: json
              inputParameters:
                - name: patient
                  in: query
                  type: string
                  required: true
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: Condition
          path: /Condition
          operations:
            - name: searchCondition
              method: GET
              description: Search Condition resources for a patient
              outputRawFormat: json
              inputParameters:
                - name: patient
                  in: query
                  type: string
                  required: true
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: Encounter
          path: /Encounter
          operations:
            - name: searchEncounter
              method: GET
              description: Search Encounter resources for a patient
              outputRawFormat: json
              inputParameters:
                - name: patient
                  in: query
                  type: string
                  required: true
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: Observation
          path: /Observation
          operations:
            - name: searchObservation
              method: GET
              description: Search Observation resources for a patient
              outputRawFormat: json
              inputParameters:
                - name: patient
                  in: query
                  type: string
                  required: true
                - name: category
                  in: query
                  type: string
                  required: false
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: Immunization
          path: /Immunization
          operations:
            - name: searchImmunization
              method: GET
              description: Search Immunization resources for a patient
              outputRawFormat: json
              inputParameters:
                - name: patient
                  in: query
                  type: string
                  required: true
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: Procedure
          path: /Procedure
          operations:
            - name: searchProcedure
              method: GET
              description: Search Procedure resources for a patient
              outputRawFormat: json
              inputParameters:
                - name: patient
                  in: query
                  type: string
                  required: true
              outputParameters:
                - name: result
                  type: object
                  value: $.
      authentication:
        type: bearer
        token: '{{env.AHC_PATIENT_BEARER_TOKEN}}'
  exposes:
    - type: rest
      namespace: ahc-patient-access-rest
      port: 8080
      description: >-
        REST adapter for AmeriHealth Caritas Patient Access. One
        Spectral-compliant resource per consumed operation, prefixed
        with /v1.
      resources:
        - path: /v1/patient
          name: patient
          description: Read patient
          operations:
            - method: GET
              name: readPatient
              description: Read patient by id
              call: ahc-patient-access.readPatient
              with:
                id: rest.id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/allergies
          name: allergies
          description: Search AllergyIntolerance for a patient
          operations:
            - method: GET
              name: searchAllergies
              description: Search AllergyIntolerance
              call: ahc-patient-access.searchAllergyIntolerance
              with:
                patient: rest.patient
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/conditions
          name: conditions
          description: Search Condition for a patient
          operations:
            - method: GET
              name: searchConditions
              description: Search Condition
              call: ahc-patient-access.searchCondition
              with:
                patient: rest.patient
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/encounters
          name: encounters
          description: Search Encounter for a patient
          operations:
            - method: GET
              name: searchEncounters
              description: Search Encounter
              call: ahc-patient-access.searchEncounter
              with:
                patient: rest.patient
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/observations
          name: observations
          description: Search Observation for a patient
          operations:
            - method: GET
              name: searchObservations
              description: Search Observation
              call: ahc-patient-access.searchObservation
              with:
                patient: rest.patient
                category: rest.category
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/immunizations
          name: immunizations
          description: Search Immunization for a patient
          operations:
            - method: GET
              name: searchImmunizations
              description: Search Immunization
              call: ahc-patient-access.searchImmunization
              with:
                patient: rest.patient
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/procedures
          name: procedures
          description: Search Procedure for a patient
          operations:
            - method: GET
              name: searchProcedures
              description: Search Procedure
              call: ahc-patient-access.searchProcedure
              with:
                patient: rest.patient
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: ahc-patient-access-mcp
      port: 9090
      transport: http
      description: >-
        MCP adapter for AmeriHealth Caritas Patient Access. One tool
        per consumed operation, routed inline through this capability's
        consumes block. All tools are read-only; PHI hygiene is the
        agent's responsibility.
      tools:
        - name: read-patient
          description: Read Patient by id
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-patient-access.readPatient
          with:
            id: tools.id
        - name: search-allergy-intolerance
          description: Search AllergyIntolerance for a patient
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-patient-access.searchAllergyIntolerance
          with:
            patient: tools.patient
        - name: search-condition
          description: Search Condition for a patient
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-patient-access.searchCondition
          with:
            patient: tools.patient
        - name: search-encounter
          description: Search Encounter for a patient
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-patient-access.searchEncounter
          with:
            patient: tools.patient
        - name: search-observation
          description: Search Observation for a patient
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-patient-access.searchObservation
          with:
            patient: tools.patient
            category: tools.category
        - name: search-immunization
          description: Search Immunization for a patient
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-patient-access.searchImmunization
          with:
            patient: tools.patient
        - name: search-procedure
          description: Search Procedure for a patient
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-patient-access.searchProcedure
          with:
            patient: tools.patient