Tross
CoverMyMeds

Get prior authorization

Get prior authorization in CoverMyMeds

POSThttps://api.ontross.com/api/integrations/covermymeds/get-prior-authorization
Request Fields
input.request_key
string
required
Prior Authorization request key from the case's ProcessPa task, not the case key.
Example
"BEXAMPLE"
auth_id
string
required
Saved connection to run this operation through, from the Authentication page. It decides which practice and login the call uses.
Example
"00000000-0000-4000-8000-000000000000"
Output Fields
summary
object
Selected values combined from request and optional clinical responses.
summary.request_key
string
Prior authorization identifier supplied by the caller.
Example
"BEXAMPLE"
summary.response_status
string
Decision indicator copied from the required request response.
Example
"approved"
summary.plan_outcome
string
Clinical decision value, falling back to the request's request_outcome.
Example
"favorable"
summary.approved
boolean
Whether normalized response status, otherwise outcome, equals approved or favorable.
Example
true
summary.user_facing_status
string
Display label supplied by the optional clinical response.
Example
"Approved"
summary.authorization_effective_date
string
Coverage start copied unchanged from clinical details, otherwise the request.
Example
"2026-09-08"
summary.authorization_expiration_date
string
Coverage end copied unchanged from the clinical authorization period.
Example
"2027-09-08"
summary.patient
object
Demographic details from the optional clinical response.
summary.prescriber
object
Ordering clinician details from the optional clinical response.
summary.pharmacy
object
Dispensing organization details from the optional clinical response.
summary.payer
object
Insurance organization details from the optional clinical response.
summary.prescription
object
Medication order details from the optional clinical response.
summary.diagnosis_fields
object
Enumerated clinical values, not necessarily limited to diagnoses.
summary.attachments
array
Document entries from clinical details, defaulting to an empty collection.
request
object
Complete /api/requests response, including every section, row, question, answer, and event on the PA view.
clinical_details
object
Complete /redacted response when available, including patient, prescriber, payer, prescription, outcome, dates, attachment metadata, and document URLs.
history
array
Optional activity entries, absent when their endpoint returns 404.
reminders
array
Optional follow-up entries, absent when their endpoint returns 404.
unavailable_sources
array
Optional page sources that returned 404. Null distinguishes absence from an empty response.
Code
curl --request POST \
  --url https://api.ontross.com/api/integrations/covermymeds/get-prior-authorization \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"request_key":"BEXAMPLE"},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "request_key": "BEXAMPLE"
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "summary": {
      "request_key": "BEXAMPLE",
      "response_status": "approved",
      "plan_outcome": "favorable",
      "approved": true,
      "user_facing_status": "Approved",
      "authorization_effective_date": "2026-09-08",
      "authorization_expiration_date": "2027-09-08",
      "patient": {},
      "prescriber": {},
      "pharmacy": {},
      "payer": {},
      "prescription": {},
      "diagnosis_fields": {},
      "attachments": [
        {}
      ]
    },
    "request": {},
    "clinical_details": {},
    "history": [
      {}
    ],
    "reminders": [
      {}
    ],
    "unavailable_sources": [
      "string"
    ]
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}