Optum Eligibility API

Medical Eligibility

Business capability
Eligibility & Benefits Verification BC-2800.30

Operations 4

POST /medicalnetwork/eligibility/v3/ Check Eligibility #
POST /medicalnetwork/eligibility/v3/raw-x12 Check Eligibility x12 #
POST /eligibility/v1/pre-service/member Call checkEligibility query #
POST /oihub/dental/eligibility/preservice/v1 Pre-Care Eligibility Check #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/optum-eligibility-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

optum-eligibility-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Optum Eligibility API
  version: '1.0'
  description: 'Operations tagged Eligibility across 3 of this provider''s published API definitions: optum-medical-network-eligibility-v3-openapi.yml, optum-optum-real-pre-service-eligibility-api-openapi.yml, optum-real-dental-pre-care-eligibility-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://sandbox-apigw.optum.com
  description: ''
- url: https://sandbox-apigw.optum.com/oihub
tags:
- name: Eligibility
  description: Medical Eligibility
paths:
  /medicalnetwork/eligibility/v3/:
    post:
      tags:
      - Eligibility
      summary: Check Eligibility
      description: Accepts 270 EDI json object model and produces a json object model of a 271 response
      operationId: medicalEligibility
      parameters:
      - name: x-chng-trace-id
        in: header
        required: false
        schema:
          type: string
      - name: Authorization
        in: header
        description: 'Bearer Your-Access-Token<br/>Example: <b>Bearer eyJraWQiOiIxIiwid…</b>'
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MedicalEligibility'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
    servers:
    - url: https://sandbox-apigw.optum.com
      description: ''
  /medicalnetwork/eligibility/v3/raw-x12:
    post:
      tags:
      - Eligibility
      summary: Check Eligibility x12
      description: Takes json with a single string property 'x12' that should have a 270 edi string and produces a json response with a single 'x12' property that should have a 271 edi string
      operationId: rawX12
      parameters:
      - name: x-chng-trace-id
        in: header
        required: false
        schema:
          type: string
      - name: Authorization
        in: header
        description: 'Bearer Your-Access-Token<br/>Example: <b>Bearer eyJraWQiOiIxIiwid…</b>'
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RawX12Request'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
    servers:
    - url: https://sandbox-apigw.optum.com
      description: ''
  /eligibility/v1/pre-service/member:
    post:
      tags:
      - Eligibility
      summary: Call checkEligibility query
      security:
      - oAuth:
        - read_healthcheck
      parameters:
      - name: providerTaxId
        in: header
        description: Provider Tax ID
        required: true
        schema:
          example: '123456789'
          type: string
      - name: x-optum-consumer-correlation-id
        in: header
        description: Unique UUID to track the transaction
        required: false
        schema:
          example: x-optum-consumer-correlation-id
          type: string
      - name: environment
        in: header
        description: Environment
        required: false
        schema:
          example: sandbox
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    description: Eligibility Pre-Check Response data
                    $ref: '#/components/schemas/EligibilityPreCheckResponseWrapper'
              example:
                data:
                  checkEligibility:
                    eligibility:
                    - eligibilityInfo:
                        trnId: dsfd-asdsd-asdasd-adad-aasdasd
                        member:
                          memberId: '840868613'
                          firstName: DARLA
                          lastName: Brown
                          middleName: J
                          suffix: Jr.
                          dateOfBirth: '1981-06-14'
                          gender: F
                          relationshipCode: '000'
                          dependentSequenceNumber: '00'
                          individualRelationship:
                            code: EE
                            description: subscriber
                          relationshipType:
                            code: EE
                            description: subscriber
                        contact:
                          addresses:
                          - type: Postal/Mailing/Remit
                            street1: 1234 CHARDAVE
                            street2: Apt 101
                            city: Hastings
                            state: TX
                            country: US
                            zip: '12133'
                            zip4: 12133-4567
                        insuranceInfo:
                          policyNumber: 708547
                          eligibilityStartDate: '2020-01-01'
                          eligibilityEndDate: '2020-12-31'
                          planStartDate: '2020-01-01'
                          planEndDate: '2020-12-31'
                          policyStatus: Past Policy
                          planTypeDescription: ''
                          groupName: Indiana Acute nursing
                          address:
                            type: Postal/Mailing/Remit
                            street1: 1234 CHARDAVE
                            street2: Apt 101
                            city: Hastings
                            state: TX
                            country: US
                            zip: '12133'
                            zip4: 12133-4567
                          stateOfIssueCode: IL
                          productType: EPO
                          productId: '123'
                          productCode: '9'
                          payerId: '87726'
                          lineOfBusinessCode: E&I
                          governmentProgramCode: '2'
                          coverageType: Medical
                          insuranceTypeCode: HN
                          insuranceType: Health Maintenance Organization (HMO)
                        associatedIds:
                          alternateId: '840868613'
                          medicaidRecipientId: '123456'
                          exchangeMemberId: '654321'
                          alternateSubscriberId: '12345'
                          hicNumber: HIC123456
                          mbiNumber: '123456'
                          subscriberMemberFacingIdentifier: '12345'
                          survivingSpouseId: '1234'
                          subscriberId: 313782034
                          memberReplacementId: '123456'
                          legacyMemberId: '654321'
                          healthInsuranceExchangeId: '929292'
                        planLevels:
                        - level: deductibleInfo/outOfPocket/coPayMax
                          family:
                          - networkStatus: InNetwork/OutOfNetwork/Tier1/Tier2
                            planAmount: '234.56'
                            planAmountFrequency: Calendar Year
                            remainingAmount: '0.00'
                          individual:
                          - networkStatus: InNetwork/OutOfNetwork/Tier1/Tier2
                            planAmount: '234.56'
                            planAmountFrequency: Calendar Year
                            remainingAmount: '0.00'
                        delegatedInfo:
                        - entity: Entity name
                          payerId: SIS
                          contact:
                            phone: 010-011-0101
                            fax: 010-011-0102
                            email: entity@example.com
                          addresses:
                          - type: Postal/Mailing/Remit
                            street1: 1234 CHARDAVE
                            street2: Apt 101
                            city: Hastings
                            state: TX
                            country: US
                            zip: '12133'
                            zip4: 12133-4567
                      primaryCarePhysician:
                        lastName: Last Name
                        firstName: Samantha
                        middleName: Baum
                        phoneNumber: 123-456-7890
                        address:
                          type: Postal/Mailing/Remit
                          street1: 1234 CHARDAVE
                          street2: Apt 101
                          city: Hastings
                          state: TX
                          country: US
                          zip: '12133'
                          zip4: 12133-4567
                        affiliateHospitalName: ''
                        providerGroupName: String
                        pcpSpeciality: ''
                        pcpStartDate: '2025-07-31'
                        pcpEndDate: '2024-01-01'
                        providerNPI: ''
                        providerTIN: ''
                        acoNetworkDescription: ''
                        acoNetworkId: ''
                      coordinationOfBenefits:
                      - coordinationOfBenefitDetails:
                        - member:
                            id: '123456'
                            name: John Doe
                          policy:
                            policyNumber: '123456'
                            groupNumber: '123456'
                            coverageType: M
                            insuranceTypeCode: C
                            medicareEntitlementType: Medicaid
                            medicareEntitlementReason: Age
                            effectiveDate: '2025-12-21'
                            terminationDate: '2025-12-21'
                            verificationDate: '2025-12-21'
                          payer:
                            name: SIF
                            phoneNumber: 123-456-7890
                            address:
                              type: Postal/Mailing/Remit
                              street1: 1234 CHARDAVE
                              street2: Apt 101
                              city: Hastings
                              state: TX
                              country: US
                              zip: '12133'
                              zip4: 12133-4567
                          cobPrimacy:
                            indicator: P
                            description: Primary
                            message: COB Message
                        cobUpdateInformation:
                          cobUpdateMessage: Update Message
                          cobLastVerifiedDate: '2021-01-01'
                        disclaimer: Disclaimer Long text
                      idCardImages:
                      - side: front
                        content: REPO01|1234567890
                        contentType: image/png
                      providerNetwork:
                        status: In Network
                        tier: '1'
                        speciality: internal Med
                      serviceLevels:
                      - family:
                        - networkStatus: ' inNetwork/outOfNetwork/inNetworkTier1/inNetworkTier1PreferredLab/inNetworkTier2/inNetworkDesignatedDiagnosticProvider'
                          services:
                          - service: chiropractic
                            serviceCode: '33'
                            serviceDate: YYYY-MM-DD
                            status: '2021-01-01'
                            planAmount: '20.2'
                            remainingAmount: '0.0'
                            metYearToDateAmount: '0.0'
                            message:
                              coPay:
                                isSingleMessageDetail: false
                                isViewDetail: false
                                messages:
                                - 0% / Visit VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                subMessages:
                                - service: VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                  status: Active
                                  copay: $15
                                  frequency: Monthly
                                  msg: Message about the service
                                  startDate: '2020-01-01'
                                  endDate: '2020-12-31'
                                  minCopay: ''
                                  minCopayMsg: ''
                                  maxCopay: ''
                                  maxCopayMsg: ''
                                  isPrimaryIndicator: false
                                  exactCopay:
                                    coveredStatus: ACTIVE
                                    copayDetails:
                                    - amount: '850'
                                      serviceSetting: OP
                                limitationInfo:
                                - lmtPeriod: Annual
                                  lmtType: Visit
                                  lmtOccurPerPeriod: ''
                                  lmtDollarPerPeriod: ''
                                  message: ''
                                isMultipleCopaysFound: false
                                isMultipleCoinsuranceFound: false
                              coInsurance:
                                isSingleMessageDetail: false
                                isViewDetail: false
                                messages:
                                - 0% / Visit VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                subMessages:
                                - service: VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                  status: Active
                                  copay: $15
                                  msg: Message about the service
                                  startDate: '2020-01-01'
                                  endDate: '2020-12-31'
                                  minCopay: ''
                                  minCopayMsg: ''
                                  maxCopay: ''
                                  maxCopayMsg: ''
                                  isPrimaryIndicator: false
                                limitationInfo:
                                - lmtPeriod: Annual
                                  lmtType: Visit
                                  lmtOccurPerPeriod: ''
                                  lmtDollarPerPeriod: ''
                                  message: ''
                                isMultipleCopaysFound: false
                                isMultipleCoinsuranceFound: false
                              deductible:
                                isSingleMessageDetail: false
                                isViewDetail: false
                                messages:
                                - 0% / Visit VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                subMessages:
                                - service: VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                  status: Active
                                  copay: $15
                                  msg: Message about the service
                                  startDate: '2020-01-01'
                                  endDate: '2020-12-31'
                                  minCopay: ''
                                  minCopayMsg: ''
                                  maxCopay: ''
                                  maxCopayMsg: ''
                                  isPrimaryIndicator: false
                                limitationInfo:
                                - lmtPeriod: Annual
                                  lmtType: Visit
                                  lmtOccurPerPeriod: ''
                                  lmtDollarPerPeriod: ''
                                  message: ''
                                isMultipleCopaysFound: false
                                isMultipleCoinsuranceFound: false
                              benefitsAllowed:
                                isSingleMessageDetail: false
                                isViewDetail: false
                                messages:
                                - 0% / Visit VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                subMessages:
                                - service: VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                  status: Active
                                  copay: $15
                                  msg: Message about the service
                                  startDate: '2020-01-01'
                                  endDate: '2020-12-31'
                                  minCopay: ''
                                  minCopayMsg: ''
                                  maxCopay: ''
                                  maxCopayMsg: ''
                                  isPrimaryIndicator: false
                                limitationInfo:
                                - lmtPeriod: Annual
                                  lmtType: Visit
                                  lmtOccurPerPeriod: ''
                                  lmtDollarPerPeriod: ''
                                  message: ''
                                isMultipleCopaysFound: false
                                isMultipleCoinsuranceFound: false
                              benefitsRemaining:
                                isSingleMessageDetail: false
                                isViewDetail: false
                                messages:
                                - 0% / Visit VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                subMessages:
                                - service: VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                  status: Active
                                  copay: $15
                                  msg: Message about the service
                                  startDate: '2020-01-01'
                                  endDate: '2020-12-31'
                                  minCopay: ''
                                  minCopayMsg: ''
                                  maxCopay: ''
                                  maxCopayMsg: ''
                                  isPrimaryIndicator: false
                                limitationInfo:
                                - lmtPeriod: Annual
                                  lmtType: Visit
                                  lmtOccurPerPeriod: ''
                                  lmtDollarPerPeriod: ''
                                  message: ''
                                isMultipleCopaysFound: false
                                isMultipleCoinsuranceFound: false
                              coPayList:
                              - placeOfService: Office
                                copay: $0 / Visit
                                service: diagnosticLab
                                startDate: '2020-01-01'
                                endDate: '2020-01-01'
                                messages:
                                - '[DESIGNATED DIAGNOSTIC PROVIDER]'
                              coInsuranceList:
                              - placeOfService: Office
                                coinsurancePercent: 20% / Visit
                                service: diagnosticLab
                                messages:
                                - '[DESIGNATED DIAGNOSTIC PROVIDER]'
                                startDate: '2024-01-01'
                                endDate: '2024-12-31'
                        individual:
                        - networkStatus: ' inNetwork/outOfNetwork/inNetworkTier1/inNetworkTier1PreferredLab/inNetworkTier2/inNetworkDesignatedDiagnosticProvider'
                          services:
                          - service: chiropractic
                            serviceCode: '33'
                            serviceDate: YYYY-MM-DD
                            status: '2021-01-01'
                            planAmount: '20.2'
                            remainingAmount: '0.0'
                            metYearToDateAmount: '0.0'
                            message:
                              coPay:
                                isSingleMessageDetail: false
                                isViewDetail: false
                                messages:
                                - 0% / Visit VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                subMessages:
                                - service: VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                  status: Active
                                  copay: $15
                                  frequency: Monthly
                                  msg: Message about the service
                                  startDate: '2020-01-01'
                                  endDate: '2020-12-31'
                                  minCopay: ''
                                  minCopayMsg: ''
                                  maxCopay: ''
                                  maxCopayMsg: ''
                                  isPrimaryIndicator: false
                                  exactCopay:
                                    coveredStatus: ACTIVE
                                    copayDetails:
                                    - amount: '850'
                                      serviceSetting: OP
                                limitationInfo:
                                - lmtPeriod: Annual
                                  lmtType: Visit
                                  lmtOccurPerPeriod: ''
                                  lmtDollarPerPeriod: ''
                                  message: ''
                                isMultipleCopaysFound: false
                                isMultipleCoinsuranceFound: false
                              coInsurance:
                                isSingleMessageDetail: false
                                isViewDetail: false
                                messages:
                                - 0% / Visit VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                subMessages:
                                - service: VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                  status: Active
                                  copay: $15
                                  msg: Message about the service
                                  startDate: '2020-01-01'
                                  endDate: '2020-12-31'
                                  minCopay: ''
                                  minCopayMsg: ''
                                  maxCopay: ''
                                  maxCopayMsg: ''
                                  isPrimaryIndicator: false
                                limitationInfo:
                                - lmtPeriod: Annual
                                  lmtType: Visit
                                  lmtOccurPerPeriod: ''
                                  lmtDollarPerPeriod: ''
                                  message: ''
                                isMultipleCopaysFound: false
                                isMultipleCoinsuranceFound: false
                              deductible:
                                isSingleMessageDetail: false
                                isViewDetail: false
                                messages:
                                - 0% / Visit VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                subMessages:
                                - service: VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                  status: Active
                                  copay: $15
                                  msg: Message about the service
                                  startDate: '2020-01-01'
                                  endDate: '2020-12-31'
                                  minCopay: ''
                                  minCopayMsg: ''
                                  maxCopay: ''
                                  maxCopayMsg: ''
                                  isPrimaryIndicator: false
                                limitationInfo:
                                - lmtPeriod: Annual
                                  lmtType: Visit
                                  lmtOccurPerPeriod: ''
                                  lmtDollarPerPeriod: ''
                                  message: ''
                                isMultipleCopaysFound: false
                                isMultipleCoinsuranceFound: false
                              benefitsAllowed:
                                isSingleMessageDetail: false
                                isViewDetail: false
                                messages:
                                - 0% / Visit VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                subMessages:
                                - service: VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                  status: Active
                                  copay: $15
                                  msg: Message about the service
                                  startDate: '2020-01-01'
                                  endDate: '2020-12-31'
                                  minCopay: ''
                                  minCopayMsg: ''
                                  maxCopay: ''
                                  maxCopayMsg: ''
                                  isPrimaryIndicator: false
                                limitationInfo:
                                - lmtPeriod: Annual
                                  lmtType: Visit
                                  lmtOccurPerPeriod: ''
                                  lmtDollarPerPeriod: ''
                                  message: ''
                                isMultipleCopaysFound: false
                                isMultipleCoinsuranceFound: false
                              benefitsRemaining:
                                isSingleMessageDetail: false
                                isViewDetail: false
                                messages:
                                - 0% / Visit VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                subMessages:
                                - service: VARIED BENEFIT.REFER TO PLAN EVIDENCE OF COVERAGE FOR BENEFITS AND LIMITATIONS
                                  status: Active
                                  copay: $15
                                  msg: Message about the service
                                  startDate: '2020-01-01'
                                  endDate: '2020-12-31'
                                  minCopay: ''
                                  minCopayMsg: ''
                                  maxCopay: ''
                                  maxCopayMsg: ''
                                  isPrimaryIndicator: false
                                limitationInfo:
                                - lmtPeriod: Annual
                                  lmtType: Visit
                                  lmtOccurPerPeriod: ''
                                  lmtDollarPerPeriod: ''
                                  message: ''
                                isMultipleCopaysFound: false
                                isMultipleCoinsuranceFound: false
                              coPayList:
                              - placeOfService: Office
                                copay: $0 / Visit
                                service: diagnosticLab
                                startDate: '2020-01-01'
                                endDate: '2020-01-01'
                                messages:
                                - '[DESIGNATED DIAGNOSTIC PROVIDER]'
                              coInsuranceList:
                              - placeOfService: Office
                                coinsurancePercent: 20% / Visit
                                service: diagnosticLab
                                messages:
                                - '[DESIGNATED DIAGNOSTIC PROVIDER]'
                                startDate: '2024-01-01'
                                endDate: '2024-12-31'
                      additionalInfo:
                        fundingType: Fully Insuredss
                        businessSegment: Small Business
                        sizeDefinitionDescription: Small Group
                        revenueArrangementDescription: Level Funded
                        hsa: 'NO'
                        cdhp: 'NO'
                        cmsHId: H1889
                        cmsPackageBenefitPlanCode: '025'
                        cmsSegmentId: '000'
                        cmsContractId: H1889-025-000
                        benefitPlanId: '47544'
                        virtualVisit: 'NO'
                        designatedVirtualClinicNetwork: Y
                        medicaidVariableCode: '12345'
                        hraBalance: '1000.00'
                        hraMessage: HRA available
                        hraUnavailableMessage: N/A
                        graceMessageByState: Texas has a grace period of 90 days
                        gracePaidThrough: '2025-03-31'
                        gracePeriodMonth: March
                        medicareGuidelines: false
                        medicareEntitlementReason: Age
                        medicaidEntitlement:
                        - waiverLiabilityList:
                          - startDate: '2020-01-01'
                            endDate: '2020-12-31'
                            amount: '100.00'
                            amountFrequency: Monthly
                            remainingAmount: '50.00'
                            metYtdAmount: '25.00'
                          patientLiabilityList:
                          - startDate: '2020-01-01'
                            endDate: '2020-12-31'
                            amount: '100.00'
                            amountFrequency: Monthly
                            remainingAmount: '50.00'
                            metYtdAmount: '25.00'
                          transferOfPropertyPenaltyPeriod:
                          - startDate: '2020-01-01'
                            endDate: '2021-12-31'
                      otherBeneficiaries:
                      - memberId: '840868613'
                        firstName: DARLA
                        lastName: Brown
                        middleName: J
                        suffix: Jr.
                        dateOfBirth: '1981-06-14'
                        gender: F
                        relationshipCode: '000'
                        dependentSequenceNumber: '00'
                        individualRelationship:
                          code: EE
                          description: subscriber
                        relationshipType:
                          code: EE
                          description: subscriber
          description: Successful response
        '400':
          content:
            application/json:
              example:
                errors:
                - message: 'Validation error (FieldUndefined@[checkEligibility/Eligib

# --- truncated at 32 KB (186 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/optum/refs/heads/main/openapi/optum-eligibility-api-openapi.yml