Tross
Demo dataBook a demo
DENTRIX-ASCEND

Attach coverage

Attach a carrier plan to a patient, and prove it is on the chart.

POSThttps://preview.ontross.com/api/integrations/dentrix-ascend/attach-coverage
Request Fields
input.patient_id
string
required
Patient chart identifier.
Example
"64000004467586"
input.carrier_insurance_plan_id
string
required
The carrier plan to attach, from fetch-insurance-carriers.
Example
"64000000451392"
input.plan_subscriber_id
string
required
The member or subscriber id printed on the patient's card.
Example
"W123456789"
input.start_date
string
The date this coverage starts, YYYY-MM-DD. Defaults to today in the practice's own timezone -- which is the only 'today' that matches what the front desk sees, and not this process's clock.
Example
"2026-10-19"
input.coordination_order
integer
1 for primary, 2 for secondary. Attaching a second coverage is refused unless this says 2, so a new plan cannot silently displace the primary one.
Example
1
Default
1
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
patient_insurance_plan_id
string
The created coverage, for the other insurance operations.
Example
"64999999731842"
patient_id
string
The chart it was attached to.
carrier_insurance_plan_id
string
The carrier plan attached.
plan_subscriber_id
string
Member id on the record.
coordination_order
integer
1 primary, 2 secondary.
eligible
string
Always OTHER on a new coverage: not yet verified.
Example
"OTHER"
verified
boolean
True only after the coverage was read back from the chart.
Example
true
Code
curl --request POST \
  --url https://preview.ontross.com/api/integrations/dentrix-ascend/attach-coverage \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"patient_id":"64000004467586","carrier_insurance_plan_id":"64000000451392","plan_subscriber_id":"W123456789","start_date":"2026-10-19","coordination_order":1},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "patient_id": "64000004467586",
    "carrier_insurance_plan_id": "64000000451392",
    "plan_subscriber_id": "W123456789",
    "start_date": "2026-10-19",
    "coordination_order": 1
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "patient_insurance_plan_id": "64999999731842",
    "patient_id": "string",
    "carrier_insurance_plan_id": "string",
    "plan_subscriber_id": "string",
    "coordination_order": 0,
    "eligible": "OTHER",
    "verified": true
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}