Dentrix Ascend Fetch appointments

POSThttps://preview.ontross.com/api/integrations/dentrix-ascend/fetch-appointments

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"

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

curl --request POST \
  --url https://preview.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"
}