Introduction
The MyMenopauseRx Developer API — start with the public provider directory.
The MyMenopauseRx Developer API lets partners build on our care infrastructure for women in menopause. Today it exposes the public provider directory — our Menopause Society Certified clinician roster, complete with credentials, licensed states, accepted insurance, and appointment types.
This is the same data that powers our own "find a provider" experience, served over a clean, predictable JSON API you can read directly from a browser or a backend.
Base URL
https://api.mymenopauserx.comAll endpoints are versioned under /v1. Responses are JSON. The directory is
public and read-only — no API key, no BAA, no CORS gymnastics.
What's available
The public read API is live and stable: the provider directory
(/v1/providers, /v1/providers/{slug}), appointment types
(/v1/appointment-types), availability (/v1/availability), and two discovery
endpoints — served states (/v1/states) and accepted insurances
(/v1/insurances) — that enumerate the valid state and insurance filter
values so you never have to hard-code them. It's all read-only and needs no
key. Have a use case we don't cover yet?
Talk to partnerships.
What you can build
Provider directory widget
Search and filter the roster by state, insurance, provider type, or
gender — paginated with limit and offset.
Provider profile pages
Render a full public profile from a stable slug: bio, education, certifications, clinical interests, and accepted insurance by state.
Appointment types by state
List the visit types offered in a state — each with its modality (video or async) — to drive a booking UI.
Availability pre-check
Look up the next available appointment in a state (optionally by type) before a patient ever signs up.
Conventions
- Identifiers — providers have a stable, opaque
idand a human-readableslug. Link byslug; store theid. Each profile also carries a canonicalprofileUrlyou can link to directly. - Pagination — list responses echo back the
limitandoffsetapplied (after clamping) plus atotalcount across all pages. - States — two-letter US state codes (
CA,NY, …) throughout. Don't hard-code them:/v1/statesreturns the states we actually serve, each with anappointmentTypeCountso you can skip the empty ones. A profile'sstatesLicensedandstatesAcceptingPatientsare separate lists: thestatefilter matches licensure, so checkstatesAcceptingPatientswhen you need to know who's actually taking new patients. - Filtering — you can filter the list by
state,insurance,providerType(a camelCase enum:physician,nursePractitioner), andgender. The acceptedinsurancevalues come from/v1/insurances(optionally scoped to a state), so you can populate a filter rather than guessing.menopauseSocietyCertifiedis returned on every profile but is not a filter — read it per-provider rather than querying for it. - Nullability — optional fields such as
genderandheadshotUrlare nullable; handle anull(or absent) value rather than assuming the field is always populated.