> ## Documentation Index
> Fetch the complete documentation index at: https://docs.haau3.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Slot Publisher

> haau3's reference SMART Scheduling Links feed — a conformant, openly fetchable $bulk-publish publisher you can connect to directly while evaluating the Scheduling API.

Alongside the [Scheduling API](/scheduling/smart-scheduling-links) — which plays the
**Slot Aggregator** role — haau3 also operates a small **Slot Publisher**: its own
[SMART Scheduling Links](https://build.fhir.org/ig/HL7/smart-scheduling-links) `$bulk-publish`
feed of provider availability.

## A reference feed, not a product

The Slot Publisher is primarily a **contribution to the open SMART Scheduling Links standard** —
a real, conformant reference feed that publishers, clients, and tooling can validate against. It
is **not** a billed platform API and is **not** part of the B2B product surface. The product is
the **aggregator** (the [Scheduling API](/scheduling/smart-scheduling-links)).

Because an SSL feed is meant to be openly fetchable, the publisher requires **no API key** — unlike
the `/v1/scheduling/*` aggregator endpoints, which are key-authenticated.

## Why it's hosted on the platform

Hosting the feed at `api.haau3.com` lets any organization **evaluating the haau3 Scheduling API**
test a **direct connection to a real Slot Publisher** with zero setup — point your own client,
ingestion worker, or public SSL tooling at a single URL instead of standing up a feed or
integrating a third party. It's the simplest way to see the publisher → aggregator → client flow
end to end.

Our own aggregator ingests this same feed, so what you fetch directly here is exactly what flows
into `GET /v1/scheduling/slots` under the `haau3` publisher slug. You can compare the two sides:
the raw publisher feed, and the normalized, unified result the aggregator serves.

## Endpoints

Both are public (no API key) and serve non-PHI synthetic data.

* `GET https://api.haau3.com/scheduling/$bulk-publish` — the `$bulk-publish` manifest
  (`transactionTime` + an `output[]` array of absolute NDJSON file URLs).
* `GET https://api.haau3.com/scheduling/{Resource}.ndjson` — one newline-delimited JSON file per
  resource type (`Location`, `Practitioner`, `PractitionerRole`, `Schedule`, `Slot`), served as
  `application/fhir+ndjson`.

```bash theme={null}
# Read the manifest, then fetch the slots it lists — no key required.
curl https://api.haau3.com/scheduling/\$bulk-publish
curl https://api.haau3.com/scheduling/Slot.ndjson
```

## What's in the feed

A small, curated dataset built to exercise representative SSL scenarios so you can see how each
maps through the aggregator:

* **Virtual vs in-person** appointments (`Location.physicalType`).
* **Accepting-patients** states: new patients, existing patients only, existing patients and
  families, and a not-accepting example (the aggregator stores it but never serves it).
* **Multiple service types and provider specialties** (HL7 service-type and NUCC codes).
* **Booking deep links and phone numbers** (SSL booking extensions).

The data conforms to the SSL profiles — it passes the same base-FHIR and profile validation the
aggregator applies on ingest — so it's a safe, predictable target for testing a Slot Discovery
Client or your own aggregator. Slot times fall within the current demo window; the dataset is
synthetic reference data, not live availability.

## How it relates to the aggregator

|          | Slot Publisher (this feed)                          | Scheduling API (aggregator)                              |
| -------- | --------------------------------------------------- | -------------------------------------------------------- |
| Role     | Publishes one provider's availability               | Combines many publishers into unified search             |
| Endpoint | `/scheduling/$bulk-publish` (+ NDJSON)              | `/v1/scheduling/slots` (+ `publishers`, `service-types`) |
| Auth     | Public, no key                                      | API key required                                         |
| Format   | Raw FHIR NDJSON                                     | Denormalized [`Slot`](/api-reference) JSON               |
| Purpose  | Open-standard reference / direct-connection testing | The haau3 B2B product                                    |

To consume the aggregator instead, start with the [Quickstart](/quickstart) and the
[SMART Scheduling Links](/scheduling/smart-scheduling-links) overview.