How to Order
Overview

How To Create Orders

You will need to add the token as part of the "Authorization" header, using the "Bearer" authentication scheme. Here are the steps to include it in the header:

APIs

GraphQL API

A live instance of the GraphQL API used for creating orders.

REST API

A live instance of the Swagger UI used for creating orders.

Order Sections

  • requisitionNumber: unique identifiers that allow every requisition to be tracked.

  • patient: patient information. There must be a patient object present to create an order.

  • products: product list is required with at least one product. Check the Panel Selection for more information on how to select the available tests.

  • clinical: an optional section that defines personal and family clinical information about the patient

    • personalCancerHistory: personal history of cancer. It's organized by cancer types inputs, each with its specific questions (if necessary).

    • familyCancerHistory: family history of cancer. It's organized by the family relationship type and its cancer history.

    • cancerRisk: breast cancer risk information.

    • boneMarrowTransplantRecipient: bone marrow transplants may use cells from your own body (autologous transplant) or from a donor (allogeneic transplant). If allogeneic, the test is invalid.

    • bloodTransfusionRecipient: information on last blood transfusion. If within 28 days, the test is invalid.

  • billing: an optional section that defines the billing information detail such as insurance information and test/billing specific authorization information

  • providerAccounts: provider specific information. If list exists at least one Provider Account object is required

  • specimens: specimen/sample specific information associated with this order.

  • notes: any free-form notes associated with this order.

  • testPreferenceCode: An optional field that contains the test preference code.

Panel Selection

Test(s)
GraphQL API - products: [ProductInput!]!

MYRIAD BRACANALYSIS AND MYRISK / NOTE 2 TESTS

products: [
  {
    product: BRACANALYSIS,
    updateTo: MYRISK,
    cdx: false,
    reflex: false,
    stat: false
  }
]

MYRIAD INTEGRATED BRACANALYSIS / BRCA 1 BRCA 2 ONLY

products: [
  {
    product: BRACANALYSIS,
    cdx: false,
    reflex: false,
    stat: false
  }
]

MYRIAD MULTISITE 3 W/ OPTION TO REFLEX

products: [
  {
    product: MULTISITE3,
    updateTo: BRACANALYSIS,
    cdx: false,
    reflex: true,
    stat: false
  },
  {
    product: MULTISITE3,
    updateTo: MYRISK,
    cdx: false,
    reflex: true,
    stat: false
  }
]
products: [
  {
    product: MULTISITE3,
    updateTo: BRACANALYSIS,
    cdx: false,
    reflex: true,
    stat: false
  }
]
products: [
  {
    product: MULTISITE3,
    cdx: false,
    reflex: false,
    stat: false
  }
]

MYRIAD COLARIS AP AND MYRISK / NOTE 2 TESTS

products: [
  {
    product: COLARISAP,
    updateTo: MYRISK,
    cdx: false,
    reflex: false,
    stat: false
  }
]

MYRIAD COLARIS PLUS AND MYRISK / NOTE 2 TESTS

products: [
  {
    product: COLARIS,
    updateTo: MYRISK,
    cdx: false,
    reflex: false,
    stat: false
  }
]

MYRIAD COLARIS AP PLUS

products: [
  {
    product: COLARISAP,
    cdx: false,
    reflex: false,
    stat: false
  }
]

MYRIAD COLARIS PLUS

products: [
  {
    product: COLARIS,
    cdx: false,
    reflex: false,
    stat: false
  }
]

MYRIAD PROLARIS PROSTATE CANCER PROGNOSTIC TEST

products: [
  {
    product: PROLARIS,
    cdx: false,
    reflex: false,
    stat: false
  }
]

Order Submission

  1. Format the Authorization Header:

You should include the JWT in the "Authorization" header of your HTTP request. The header should look like this:

Authorization: Bearer <your-JWT-token>
  • Replace <your-JWT-token> with the actual JWT token you generated in step 1.
  1. Make the Request:

You can use various programming languages and libraries to send HTTP requests to the GraphQL API. Below are a few examples:

curl --X POST --location '<https://example.com/graphql>' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <your-JWT-token>' \
  --data-raw '{"query":"mutation createOrder($order: OrderInput!) {createOrder(order: $order) {id}}","variables":{"order": <your-order-payload> }}'
  • Replace <your-JWT-token> with the JWT token obtained in step 1.
  1. Handle the Response:

Once you send the request, you will receive a response from the GraphQL API with the ID of the created entry. You can parse and handle the data according to your application's needs.

How to OrderAuthentication