API Reference
Complete API documentation for integrating TDAppointments into your applications
Authentication
All API requests require authentication using an API key. Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY
API keys are available for Enterprise plan customers. Contact us at info@techdr.in to request API access.
API Endpoints
GET
/api/v1/appointmentsAuth RequiredList all appointments
POST
/api/v1/appointmentsAuth RequiredCreate a new appointment
GET
/api/v1/appointments/{id}Auth RequiredGet appointment details
PUT
/api/v1/appointments/{id}Auth RequiredUpdate appointment
DELETE
/api/v1/appointments/{id}Auth RequiredCancel appointment
GET
/api/v1/patientsAuth RequiredList all patients
POST
/api/v1/patientsAuth RequiredCreate a new patient
GET
/api/v1/patients/{id}Auth RequiredGet patient details
GET
/api/v1/doctorsAuth RequiredList all doctors
GET
/api/v1/slots/availableAuth RequiredGet available time slots
POST
/api/v1/webhooksAuth RequiredRegister a webhook
Webhooks
Subscribe to real-time events in your TDAppointments account. Configure webhooks to receive notifications for:
- New appointment bookings
- Appointment cancellations
- Appointment rescheduling
- Payment confirmations
- Patient registrations
Rate Limits
- • Free tier: 100 requests/hour
- • Professional: 1,000 requests/hour
- • Enterprise: Custom limits
Best Practices
- • Always use HTTPS
- • Implement retry logic with exponential backoff
- • Cache responses when appropriate
- • Handle errors gracefully
Need Help with Integration?
Our developer support team is here to help. Contact us for API access, integration assistance, or technical questions.