Change Log

v1 above refers to the public API path and lifecycle. The version value inside the downloadable OpenAPI file is the specification document version and may advance independently as examples, schemas, and documentation metadata are updated.

Release Notes

v1.11 (04/08/2026)

• Updates:
  • Coverage Discovery Direct JSON Guidance Expanded
    Updated the OpenAPI specification, guides, and JSON examples to clarify that canonicalEligibilityRequest is always required while canonicalEligibilityResponse is optional for request-only qualification paths and still required for response-driven scenarios such as HMO routing and some Medicare flows.
  • Coverage Discovery Task Type Documentation Added
    Added documentation describing serial and chained task behavior in the guides and callback references.

v1.10 (04/07/2026)

• Updates:
  • Added Real-Time X12 Endpoint
    Added the rcm/eligibility/v1/real-time/x12 endpoint for real-time X12-270 transactions.
  • Added Subtenant Header
    Added support for the optional subtenantId (x-optum-subtenant-id) header on POST requests for sub-level configurations needed for API consumers' customers.

v1.9 (01/15/2026)

• Updates:
  • Exponential Backoff for Callback Retries
    Callback retries to customer postback endpoints now use an exponential backoff strategy to accommodate customer network interruptions, maintenance windows, and other transient failures.
    See more details in the public documentation:
    Customer Callback Example API – Retries
  • RTCOB Integration Now RealTime
  • The RTCOB value-added feature now uses the real-time service-bus integration, reducing response times significantly for this path from the older long-running model to an average of about 30 minutes.

v1.8 (12/15/2025)

• Updates:

  • Expanded Queryability for Transaction Search
    The GET rcm/eligibility/v1/transactions endpoint now supports additional query parameters to make patient‑centric searches more precise and efficient.
    Details available in the API reference.

    New Query Parameters:

    • patientFirstName
    • patientLastName
    • patientAccountNumber
    • medicalRecordNumber
    • memberId
    • patientDateOfBirth
    • npi — provider NPI submitted on the request
    • payerId

v1.7 (10/03/2025)

• Updates:
  • Coverage Discovery Commercial Path : Added support for facility-specific commercial payer targeting. See more about this value-add here.

v1.6 (08/20/2025)

• Updates:
  • New POST x12 API Endpoint for Coverage Discovery : rcm/eligibility/v1/coverage-discovery/x12

v1.5 (06/25/2025)

• Updates
  • Coverage Discovery added new value added feature to access RTCOB Data Lake for additional coverage.
  • Coverage Discovery response model updated to contain the optional realTime object for Real Time Enhanced Eligibility customers enrolled in integrated Coverage Discovery .
  • Get All Coverage Discovery Endpoint supports querying by task status:
    • success
    • failure
    • pending
  • Get All Transactions supports querying by patient information:
    • patientFirstName
    • patientLastName
    • patientAccountNumber
    • medicalRecordNumber
    • memberId

v1.4 (12/17/2024)

• Updates
  • Search Options Cascading, a new Coverage Discovery Path. See more here.
• Deprecations
  • Change Healthcare request and response headers (x-chng-) are no longer supported.

v1.3 (10/23/2024)

• Updates
  • [Non-Breaking] Optum rebranding of request and response headers in OpenAPI Specification, Customer Callback API example, and all documentation guides.
    • Change Healthcare request and response headers are still supported to maintain backwards compatibility.
  • Support of the x-optum-trace-id response header for traceability into customer transactions.

v1.2 (08/14/2024)

• Updates
  • New API basepath rcm/eligibility/v1
  • Added supporting documentation
    • FAQs, Getting Started, Troubleshooting and Support, etc.
  • Updated API Specifications
    • Coverage Discovery
• Deprecations
  • Payer Alias API
  • NPI Management API
  • rcmcomplete/eligibility/v1 (legacy basepath)

v1.1 (05/03/2023)

• Initial Release