openapi: 3.0.1
info:
  title: Natera EMR Ordering and Results Integration
  description: >-
    Representational model of Natera's documented EMR integration surface.
    Natera does NOT publish a public developer REST API. Test ordering and
    results delivery are provisioned per health system over the Epic Aura
    hub and point-to-point HL7, with pre-built orders in the Epic Foundation
    System. This document models that bidirectional order/results workflow
    as an HTTP interface for cataloging purposes only - the paths, schemas,
    and base URL below are NOT official, published Natera endpoints and must
    not be treated as a live API contract. Integration is established with a
    Natera EHR specialist (see https://www.natera.com/emr/).
  termsOfService: https://www.natera.com/privacy-notices/
  contact:
    name: Natera EHR Integration
    url: https://www.natera.com/emr/
  version: '0.1'
servers:
  - url: https://www.natera.com
    description: >-
      Placeholder host. Natera does not document a public REST base URL;
      integration endpoints are not publicly published.
tags:
  - name: Orders
    description: Test order submission (modeled on the documented order workflow).
  - name: Results
    description: Test results retrieval (modeled on the documented results workflow).
paths:
  /emr/orders:
    post:
      operationId: submitOrder
      tags:
        - Orders
      summary: Submit a Natera test order (representational).
      description: >-
        Models the bidirectional order leg documented for the Epic Aura hub:
        an order plus related documentation (progress notes, pathology
        reports, pedigree charts, personal/family cancer history) is
        transmitted to Natera. Not a published endpoint.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Order'
      responses:
        '202':
          description: Order accepted for processing (representational).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrderAck'
  /emr/results/{orderId}:
    get:
      operationId: getResults
      tags:
        - Results
      summary: Retrieve results for an order (representational).
      description: >-
        Models the results leg documented for the Epic Aura hub, where test
        results flow back into the patient EHR record. Not a published
        endpoint.
      parameters:
        - name: orderId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Result document for the order (representational).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Result'
components:
  schemas:
    Order:
      type: object
      properties:
        patientId:
          type: string
          description: Patient identifier within the ordering EHR.
        test:
          type: string
          description: Natera test ordered (e.g., Panorama, Horizon, Signatera, Prospera).
        orderingProvider:
          type: string
        documents:
          type: array
          description: Order-related documentation transmitted to Natera.
          items:
            type: string
    OrderAck:
      type: object
      properties:
        orderId:
          type: string
        status:
          type: string
          example: accepted
    Result:
      type: object
      properties:
        orderId:
          type: string
        test:
          type: string
        status:
          type: string
          example: final
        reportUrl:
          type: string
          description: Link to the downloadable result report.