Tross
CoverMyMeds

List requests

List requests in CoverMyMeds

POSThttps://api.ontross.com/api/integrations/covermymeds/list-requests
Request Fields
input.tab
string
'sent' is the UI's Sent to plan queue; it includes pending and decided requests. 'current' includes requests still in preparation.
Example
"sent"
Default
"sent"
Accepted values
sentcurrent
input.date_interval_days
integer
The portal's relative Date created filter.
Example
90
Default
90
Accepted values
7143090
input.page
integer
One-based portal page. Fetch successive pages to collect the cohort.
Example
1
Default
1
input.page_size
integer
Rows per page; 100 was verified against the live portal.
Example
100
Default
100
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
requests
array
Normalized authorization records from the retrieved portal response.
requests[].request_key
string
Authorization identifier copied from the portal row.
Example
"BEXAMPLE"
requests[].created_date
string
Creation day copied unchanged from the portal row.
Example
"09/08/2026"
requests[].sent_date
string
Transmission day copied unchanged from the portal row.
Example
"09/09/2026"
requests[].medication
string
Drug label copied from the portal row.
Example
"Humira"
requests[].status
string
Portal response label extracted from text or nested data.
Example
"PA Response - Approved"
requests[].decision
string
Only explicit Approved or Denied response labels count as decisions; pending and N/A stay null.
Example
"approved"
requests[].patient_first_name
string
Individual's given name copied from the portal row.
Example
"Avery"
requests[].patient_last_name
string
Individual's family name copied from the portal row.
Example
"Ellison"
requests[].patient_dob
string
Individual's birth date copied unchanged from the portal row.
Example
"04/17/1986"
requests[].source
object
Complete portal Requests row, including fields not yet normalized. May contain PHI.
tab
string
Caller-selected portal queue echoed in the response.
Example
"sent"
date_interval_days
integer
Caller-selected creation-date window echoed in days.
Example
90
page
integer
Caller-selected one-based portal index echoed in the response.
Example
1
page_size
integer
Requested row limit, not the actual returned count.
Example
100
source_total
integer
Matching row count reported by the portal.
Example
237
source_page_count
integer
Number of result pages reported by the portal.
Example
3
has_more
boolean
Whether the requested index precedes the final reported page.
Example
true
Code
curl --request POST \
  --url https://api.ontross.com/api/integrations/covermymeds/list-requests \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"tab":"sent","date_interval_days":90,"page":1,"page_size":100},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "tab": "sent",
    "date_interval_days": 90,
    "page": 1,
    "page_size": 100
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "requests": [
      {
        "request_key": "BEXAMPLE",
        "created_date": "09/08/2026",
        "sent_date": "09/09/2026",
        "medication": "Humira",
        "status": "PA Response - Approved",
        "decision": "approved",
        "patient_first_name": "Avery",
        "patient_last_name": "Ellison",
        "patient_dob": "04/17/1986",
        "source": {}
      }
    ],
    "tab": "sent",
    "date_interval_days": 90,
    "page": 1,
    "page_size": 100,
    "source_total": 237,
    "source_page_count": 3,
    "has_more": true
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}