Tross
DENTRIX-ASCEND

Fetch appointments

List scheduled visits across dates and offices.

POSThttps://api.ontross.com/api/integrations/dentrix-ascend/fetch-appointments
Request Fields
input.start_date
string
required
First day of the window (inclusive).
Example
"2026-10-14"
input.end_date
string
required
Last day of the window (inclusive).
Example
"2026-10-18"
input.location_ids
array
required
Location ids to pull the schedule for, from fetch-locations.
Example
["64000000022309"]
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
appointments
array
Scheduled visits collected across all requested days and offices.
appointments[].id
string
Unique appointment identifier returned by the schedule endpoint.
Example
"64000000026084"
appointments[].start
string
Start time, ISO 8601 (UTC).
Example
"2026-10-16T13:00:00+00:00"
appointments[].start_epoch_ms
integer
Raw start timestamp in epoch milliseconds.
Example
1792155600000
appointments[].duration_minutes
integer
Scheduled length returned as a whole number of minutes.
Example
60
appointments[].status
string
Scheduling state returned for this appointment.
Example
"CONFIRMED"
appointments[].title
string
Display label returned for the scheduled appointment.
Example
"Appointment"
appointments[].reason
string
Stated purpose returned for the scheduled visit.
Example
"Crown lengthening consultation"
appointments[].note
string
Additional appointment text returned by the schedule endpoint.
Example
"Patient requested an afternoon visit."
appointments[].patient_id
string
Person's identifier from the nested patient or patientId value.
Example
"64000004471475"
appointments[].provider_id
string
Clinician's identifier from the appointment's nested provider object.
Example
"64000000026082"
appointments[].operatory_id
string
Treatment room identifier from the appointment's nested operatory object.
Example
"64000000010661"
appointments[].location_id
string
Office identifier from the appointment's nested location object.
Example
"64000000022309"
appointments[].booked_online
boolean
Whether the schedule marks this appointment as reserved online.
Example
true
appointments[].procedures
array
Treatments collected from every visit within this appointment.
appointments[].procedures[].code
string
CDT/procedure code.
Example
"D4249.10"
appointments[].procedures[].name
string
Treatment label returned within an appointment visit.
Example
"Hard Tissue Crown Lengthening"
appointments[].procedures[].description
string
Additional treatment text returned within an appointment visit.
Example
"CrLengten"
appointments[].procedures[].status
string
Treatment workflow state returned within an appointment visit.
Example
"TREATMENT_PLAN"
count
integer
Total number of scheduled visits in the returned collection.
Example
12
Code
curl --request POST \
  --url https://api.ontross.com/api/integrations/dentrix-ascend/fetch-appointments \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"start_date":"2026-10-14","end_date":"2026-10-18","location_ids":["64000000022309"]},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "start_date": "2026-10-14",
    "end_date": "2026-10-18",
    "location_ids": [
      "64000000022309"
    ]
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "appointments": [
      {
        "id": "64000000026084",
        "start": "2026-10-16T13:00:00+00:00",
        "start_epoch_ms": 1792155600000,
        "duration_minutes": 60,
        "status": "CONFIRMED",
        "title": "Appointment",
        "reason": "Crown lengthening consultation",
        "note": "Patient requested an afternoon visit.",
        "patient_id": "64000004471475",
        "provider_id": "64000000026082",
        "operatory_id": "64000000010661",
        "location_id": "64000000022309",
        "booked_online": true,
        "procedures": [
          {
            "code": "D4249.10",
            "name": "Hard Tissue Crown Lengthening",
            "description": "CrLengten",
            "status": "TREATMENT_PLAN"
          }
        ]
      }
    ],
    "count": 12
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}