Appointments
Core Appointment Data: Extract comprehensive appointment records with intelligent processing.
Processing Modes:
- Auto (Recommended): System automatically chooses streaming (≤100K rows) or job processing (>100K rows)
- Stream: Forces real-time streaming response (recommended for ≤100K appointments)
- Job: Forces background job processing with S3 download (for large datasets)
Attributes
Attribute | Type | Description |
| integer | Unique appointment identifier |
| string | Human-readable appointment status |
| string | Status abbreviation codes |
| integer (0/1) | Cancellation flag (0 = not cancelled, 1 = cancelled) |
| integer (0/1) | Failed appointment flag (0 = not failed, 1 = failed) |
| integer (0/1) | Patient attendance flag (0 = not attended, 1 = attended) |
| integer (0/1) | Online booking flag (0 = not online, 1 = online booking) |
| string | Appointment type identifier |
| string | Appointment type description |
| date | Date of appointment (YYYY-MM-DD) |
| date-time | Scheduled start time (YYYY-MM-DD HH:MM:SS) |
| date-time | Scheduled end time (YYYY-MM-DD HH:MM:SS) |
| date-time, nullable | Actual patient arrival time |
| date-time, nullable | Actual appointment start time |
| date-time, nullable | Actual appointment end time |
| integer (minutes) | Scheduled duration in minutes |
| integer (0/1) | Linked to recall system flag (0 = no, 1 = yes) |
| integer | Associated patient identifier |
| integer | Assigned practitioner identifier |
| integer | Practice location identifier |
| date-time | Appointment creation timestamp |
| date, nullable | Original creation date (for rescheduled appointments) |
| string | User who created the appointment |
| date-time | Last update timestamp |
| string | User who last updated the appointment |
| integer (0/1) | Deletion status (0 = active, 1 = deleted) |
| integer (0/1) | Confirmation status (0 = not confirmed, 1 = confirmed) |
| integer | Appointment book/schedule identifier |
Key Features:
- Intelligent Processing: Auto-switching between streaming and job processing
- High-Volume Support: Handles millions of appointment records efficiently
- Real-Time Data: Includes both active and deleted appointments for complete audit trail
- Status Tracking: Comprehensive appointment status and workflow tracking
- Time Accuracy: Scheduled vs actual times for performance analysis
Use Cases:
- Appointment management system integration
- Schedule optimisation and analysis
- Patient flow and wait time analysis
- Practitioner utilization reporting
- Appointment outcome tracking
- Business intelligence and KPI dashboards
Header Parameters
Body Parameters
Unique customer identifier
Start date for filtering (YYYY-MM-DD format)
End date for filtering (YYYY-MM-DD format)
Filter mode - "All" (default), "Created", or "Updated"
Execution mode - "auto" (default), "stream", or "job"
Response format - "ndjson" (default), "json", or "csv"
Compression type - "none" (default), "gzip", or "zip"
Encryption - "false" (default) or "true"