clockwisemd.com APIwww.clockwisemd.com ↗
Access Clockwise MD urgent care locations via API. Fetch hospital info, check real-time appointment availability, and book visits programmatically.
curl -X GET 'https://api.parse.bot/scraper/a8d7e1d7-6a39-4bed-91fa-c0201a78324e/get_hospital_info?hospital_id=%3Chospital_id%3E' \ -H 'X-API-Key: $PARSE_API_KEY'
Get details about a hospital or urgent care location including name, address, phone number, business hours, and scheduling configuration.
| Param | Type | Description |
|---|---|---|
| hospital_id | string | The numeric ID of the hospital or urgent care location to look up. |
{
"type": "object",
"fields": {
"id": "integer hospital identifier",
"name": "string hospital name",
"group_id": "integer group this hospital belongs to",
"latitude": "number geographic latitude",
"logo_url": "string URL to hospital logo image",
"longitude": "number geographic longitude",
"time_zone": "string IANA time zone identifier",
"full_address": "string complete street address",
"phone_number": "string phone number with formatting",
"disclaimer_text": "string booking disclaimer shown to patients",
"has_registration": "boolean whether online registration is available",
"hide_clinic_address": "boolean whether address is hidden from public view",
"todays_business_hours": "string formatted hours for current day",
"scheduling_window_hours": "integer how far ahead appointments can be booked in hours",
"hide_clinic_phone_number": "boolean whether phone number is hidden from public view"
},
"sample": {
"data": {
"id": 2310,
"name": "Emergency One, Kingston , NY",
"group_id": 331,
"latitude": 41.93457129999999,
"logo_url": "https://s3.amazonaws.com/urgentq_production/uploads/hospital/logo/2310/Emergency-One-logo-2c-003-5.png",
"longitude": -74.0472214,
"time_zone": "America/New_York",
"full_address": "40 Hurley Ave, Ste 4, Kingston, NY 12401, USA",
"phone_number": "+1 (555) 012-3456",
"disclaimer_text": "Booking a visit is not an appointment. The clinic will reserve the time you select, but service times are not guaranteed and can be delayed if the clinic experiences excess demand.",
"has_registration": true,
"hide_clinic_address": false,
"todays_business_hours": "08:00 am - 04:00 pm",
"scheduling_window_hours": 48,
"hide_clinic_phone_number": false
},
"status": "success"
}
}About the clockwisemd.com API
The Clockwise MD API exposes 3 endpoints covering urgent care scheduling across Clockwise MD locations — from facility lookup to live appointment booking. Use get_hospital_info to retrieve location details including address, phone number, business hours, and time zone, get_available_times to query open slots by visit reason, and book_visit to submit a patient booking and receive a confirmed visit ID in return.
Hospital and Location Data
The get_hospital_info endpoint returns structured data for a Clockwise MD facility identified by its numeric hospital_id. Response fields include name, full_address, phone_number, latitude, longitude, time_zone (IANA format), logo_url, group_id, and disclaimer_text — the booking disclaimer text shown to patients. This endpoint is useful for building location listings or pre-populating UI before surfacing availability.
Checking Appointment Availability
The get_available_times endpoint accepts a hospital_id and an optional reason string, and returns a days array. Each day object includes the date, a day name, and a times array with display_time, an ISO 8601 time value, and an appointment_queue_id. The valid values for reason depend on the individual hospital's configuration — unsupported or unrecognized reason values will return empty times arrays rather than an error, so it is worth confirming accepted reasons via get_hospital_info first.
Booking a Visit
The book_visit endpoint is a POST that takes required patient fields — first_name, last_name, sex (M, F, or O), dob_day, dob_month, dob_year — along with optional email and reason. On success it returns a visit_id, confirmed_at timestamp, queue_name, entry_type, and the stored patient fields. Duplicate submissions using the same phone number for an existing active booking may be rejected. Use get_available_times first to obtain a valid time slot before submitting a booking.
- Display real-time wait availability for nearby Clockwise MD locations in a patient-facing mobile app
- Build an automated scheduling tool that checks
get_available_timesand books the earliest open slot for a given visit reason - Aggregate facility details — address, phone, time zone — from
get_hospital_infointo a clinic directory or map interface - Send appointment confirmation data (
visit_id,confirmed_at,queue_name) to a downstream notification or reminder system - Filter available appointment days by date range using the
daysarray fromget_available_timesto surface same-day openings - Validate patient-entered visit reasons against a hospital's accepted
reasonvalues before surfacing the booking form
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Clockwise MD have an official developer API?+
What does `get_available_times` return when an unsupported visit reason is passed?+
reason value is provided, the endpoint returns the days array with empty times arrays for each day rather than returning an error. Each day object still includes the date and day name fields. The valid reason strings vary by hospital configuration, so it is worth cross-referencing with the hospital's setup before querying availability.Does the API expose current wait times or queue position for a location?+
get_hospital_info, scheduled appointment slots via get_available_times, and visit bookings via book_visit. Live queue wait times and current queue position are not included in any response field. You can fork this API on Parse and revise it to add an endpoint targeting that data.Can I look up all Clockwise MD locations without knowing a hospital_id in advance?+
get_hospital_info and get_available_times require a hospital_id as input — there is no search or list-all endpoint that returns location IDs without prior knowledge. You can fork this API on Parse and revise it to add a location discovery endpoint.What happens if a patient tries to book a visit when their phone number already has an active booking?+
book_visit endpoint notes that duplicate bookings submitted with the same phone number may be rejected. The response on a successful booking includes a unique visit_id and a confirmed_at ISO 8601 timestamp, so the absence of these fields in a response indicates the booking was not completed.