Clockwise MD APIclockwisemd.com ↗
Access Clockwise MD urgent care data via API. Retrieve hospital details, check real-time appointment availability, and book visits programmatically.
What is the Clockwise MD API?
The Clockwise MD API exposes 3 endpoints covering urgent care location data, appointment availability, and visit booking across Clockwise MD facilities. Use get_hospital_info to retrieve a location's address, phone number, time zone, and disclaimer text by numeric hospital ID, then query get_available_times for open slots grouped by day, and finally submit a booking via book_visit with patient demographics and a selected time.
curl -X GET 'https://api.parse.bot/scraper/a8d7e1d7-6a39-4bed-91fa-c0201a78324e/get_hospital_info?hospital_id=2310' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace clockwisemd-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Clockwise MD: check hospital availability and book a visit."""
from parse_apis.clockwise_md_scheduling_api import ClockwiseMD, Sex, HospitalNotFound
client = ClockwiseMD()
# Fetch hospital details by ID
hospital = client.hospitals.get(hospital_id="2310")
print(f"Hospital: {hospital.name} at {hospital.full_address}")
print(f"Hours today: {hospital.todays_business_hours}, timezone: {hospital.time_zone}")
# Check available appointment slots (paginator yields AvailableDay items)
availability = hospital.available_times(limit=5).first()
if availability:
for day in availability.days:
if day.times:
slot = day.times[0]
print(f"First slot on {day.date}: {slot.display_time} ({slot.time})")
break
# Book a visit using a time slot from availability
try:
visit = hospital.book_visit(
first_name="Jane",
last_name="Doe",
appointment_time="2026-06-12T09:00:00.000-04:00",
dob_month="05",
dob_day="20",
dob_year="1992",
phone_number="5552223344",
sex=Sex.FEMALE,
)
print(f"Booked visit {visit.visit_id}, confirmation: {visit.confirmation_code}")
print(f"Queue: {visit.queue_name}, status: {visit.current_status}")
except HospitalNotFound as exc:
print(f"Hospital not found: {exc}")
print("exercised: hospitals.get / available_times / book_visit")
Retrieve details about a hospital or urgent care location including name, address, phone number, business hours, and scheduling configuration. Each hospital is identified by a numeric ID.
| Param | Type | Description |
|---|---|---|
| hospital_id | string | The numeric ID of the hospital or urgent care location. |
{
"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": "123 Main St, Springfield, IL 62704",
"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 - 08:00 pm",
"scheduling_window_hours": 48,
"hide_clinic_phone_number": false
},
"status": "success"
}
}About the Clockwise MD API
Hospital and Location Data
The get_hospital_info endpoint accepts a numeric hospital_id and returns a structured record for that urgent care location. Response fields include name, full_address, phone_number, time_zone (as an IANA identifier), latitude/longitude, logo_url, and a disclaimer_text string that Clockwise MD displays to patients before booking. The group_id field identifies which network or health system the facility belongs to, useful when working with multi-location groups.
Checking Appointment Availability
The get_available_times endpoint takes a hospital_id and an optional reason string describing the visit type. It returns a days array where each element contains a date and a times array. Each time entry carries both a human-readable display_time and a machine-readable ISO 8601 time value suitable for passing directly into a booking request. Visit reasons that the specific hospital does not support return an empty times array rather than an error, so check the response shape before presenting options to users.
Booking a Visit
The book_visit endpoint requires patient identity fields — first_name, last_name, dob_day, dob_month, dob_year, and sex — plus the selected appointment time from get_available_times. On success it returns a visit_id, a confirmed_at ISO 8601 timestamp, the assigned queue_name, and entry_type (typically "Online"). Duplicate submissions using the same phone number for an already-booked slot may be rejected. Email is optional; omitting it stores null in the booking record.
The Clockwise MD API is a managed, monitored endpoint for clockwisemd.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when clockwisemd.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official clockwisemd.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display real-time wait-time slot availability for a patient-facing urgent care finder app
- Automate appointment scheduling for telehealth platforms integrating Clockwise MD locations
- Populate a facility directory with address, phone, and coordinates from
get_hospital_info - Send confirmation emails using
confirmed_atandvisit_idreturned bybook_visit - Filter available slots by
reasonto surface only relevant appointment types per location - Map urgent care locations using
latitudeandlongitudefields from hospital info responses - Aggregate multi-location scheduling data by grouping facilities with matching
group_idvalues
| 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 | 100 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 offer an official developer API?+
What does `get_available_times` return when a visit reason is unsupported?+
reason value is not recognized or is unsupported by a specific hospital's configuration, the endpoint returns the day structure intact but with empty times arrays for each day. The reason and hospital_id fields are still echoed back in the response so you can identify which query produced the empty result.Are all Clockwise MD locations available, or only a subset?+
hospital_id, so it covers any location for which you supply a valid ID. There is no discovery endpoint that lists all hospital IDs. You can fork this API on Parse and revise it to add a location-search or group-listing endpoint if you need to enumerate available facilities.Can I cancel or modify an existing booking through this API?+
book_visit and reading availability via get_available_times, but does not expose cancellation or rescheduling operations. You can fork the API on Parse and revise it to add a cancellation endpoint.What happens if I submit a duplicate booking with the same phone number?+
get_available_times before each book_visit call and do not retry the same patient phone number for a slot that has already been confirmed.