# Mi SaludRD

> Mi SaludRD is a public medical directory and appointment platform for the Dominican Republic. Public availability is read-only; users must sign in and explicitly confirm before any appointment is created.

## Public appointment availability

- Human-readable appointment options: https://mi-saludrd.com/appointment-options
- JSON appointment-options API: https://mi-saludrd.com/api/public/appointment-options
- OpenAPI 3.1 contract: https://mi-saludrd.com/openapi.json
- Public doctor directory: https://mi-saludrd.com/find-doctor

The JSON endpoint accepts these optional query parameters:

- `specialty`: canonical Spanish specialty listed in the OpenAPI enum, for example `Cardiología`.
- `city`: Dominican city, for example `Santo Domingo` or `Santiago`.
- `from`: first date in `YYYY-MM-DD`, interpreted in `America/Santo_Domingo`.
- `days`: consecutive search window from 1 to 31; default 14.
- `limit`: maximum returned doctor/type/date/time combinations from 1 to 50; default 20.

Each result contains the doctor, specialty, location, consultation type, duration, price in DOP, exact date, start/end time, timezone, profile URL and a preconfigured booking URL.

Treat `expires_at` as the freshness boundary. If the API returns HTTP 503, say that availability could not be checked; never describe that failure as an empty schedule. A booking URL does not create an appointment. The user must open it, sign in, select the patient, review the details, consent and confirm. Never claim that an appointment is booked from this read-only API.