Slot Aggregator

A lightweight service that helps slot discovery client apps find appointment availability across multiple slot publishers using the SMART Scheduling Links $bulk-publish pattern. The end result is a simple, RESTful API that clients can query.

Swagger DocsOpenAPI JSONChangelogSMART Scheduling Links Spec➕ Submit a publisher

How it works

The aggregator follows a simple pipeline: ingest publisher data, transform it into a fast index, then expose it through a client-friendly API.

1) Ingest
Fetch $bulk-publish manifests and download the referenced NDJSON outputs (Schedule, Location, Slot) from all configured slot publishers.
2) Transform
Validate and reshape the NDJSON files into a availablility slots for easy consumption.
3) Expose Endpoint
Enable slot discovery clients to easily connect to multiple slot discovery publishers via a RESTful API.
API quick reference
Pick an endpoint to see what it does and which query parameters are available.
Availability search
Search for bookable slots across configured publishers.
GET /availability
  • Best for client apps that need a single API surface to discover slots across multiple servers.
  • City is optional (statewide searches are supported).
Base URL: https://availability-api-601336959692.us-central1.run.app
Query parameters
state
Required
Example: FL
Two-letter state code used to filter which publishers to scan.
service
Required
Example: general
Service key to search for. Use /services to discover valid values (optionally by state).
window
Optional
Example: next7
Time window preset used by the server to compute the search interval.
days
Optional
Example: 7
How many days of availability to return (used with windowing logic).
limit
Optional
Example: 200
Maximum number of slots to return in the response.
city
Optional
Example: Tampa
Optional city filter to narrow results within the state.
Try it
Each example opens a live response in a new tab (avoids CORS issues).
Tampa, FL — General PCP visit (next 7 days)
Find availability in Tampa for a general PCP visit in the next 7 days.
Open
availabilityFLTampageneral
Request: /availability?state=FL&service=general&window=next7&days=7&limit=200&city=Tampa
Florida (no city) — General PCP visit (next 7 days)
Same as above, but without a city filter (statewide in FL).
Open
availabilityFLstatewidegeneral
Request: /availability?state=FL&service=general&window=next7&days=7&limit=200
California — General (next 3 days)
Find general availability in CA for the next 3 days.
Open
availabilityCAgeneral
Request: /availability?state=CA&service=general&window=1-7&days=3&limit=200
Massachusetts — List services
Get the deduped list of services available in MA.
Open
servicesMA
Request: /services?state=MA
Publishers — Operational status
Check operational status of configured slot publishers.
Open
publishershealth
Request: /publishers/health?include_disabled=false&only_failed=false
Publishers — Metadata
View publisher metadata, including which states each publishes for.
Open
publishersmetadata
Request: /publishers/metadata?include_disabled=false
Feedback & feature requests
Suggestions, questions, or issues are welcome.
Email Brian
Include the request URL and what you expected to see.