Hint Health Membership API

The Membership API from Hint Health — 6 operation(s) for membership.

Documentation GitHub OpenAPI

Business capability

Subscription Lifecycle Management BC-4240

Operations 9

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /provider/memberships/{id}/bill Bill a membership from a start date · Bill Membership #

Ask an LLM

“How do I generate a bill for a patient's membership starting on a specific date?”

“Can I trigger billing on a membership manually instead of waiting for the cycle?”

Tell an agent

Bill membership {id} starting {start_date}.

Run billing on membership {id} from {start_date} onward.

POST /provider/memberships/{id}/cancel Cancel a patient membership · Cancel Membership #

Ask an LLM

“How do I cancel a patient's membership with an end date and a reason?”

“Can I record a custom cancellation reason when a member leaves the practice?”

Tell an agent destructive · confirm first

Cancel membership {id} effective {end_date} because of {cancellation_reason}.

End membership {id} on {end_date} with reason {cancellation_reason} and note {cancellation_reason_other}.

POST /provider/memberships/{id}/confirm Confirm an unconfirmed membership · Confirm Membership #

Ask an LLM

“How do I confirm a membership that is still waiting for confirmation?”

“What turns an unconfirmed membership into a confirmed one?”

Tell an agent

Confirm membership {id}.

Mark pending membership {id} as confirmed.

POST /provider/memberships Enroll patients in a membership plan · Create Membership #

Ask an LLM

“How do I enroll a patient in a membership plan with Hint?”

“Can I set a fixed monthly rate or registration fee when creating a membership?”

Tell an agent

Create a membership on plan {plan} for {membership_patients} starting {start_date}, billed every {period_in_months} months.

Enroll {membership_patients} in plan {plan} from {start_date} for {period_in_months}-month periods at {fixed_period_rate_in_cents} cents.

GET /provider/memberships List the practice's memberships · List All Memberships #

Ask an LLM

“Which memberships does my practice have right now?”

“Can I list only memberships updated or created after a certain date?”

Tell an agent

List all memberships at the practice.

List memberships updated since {updated_at}.

DELETE /provider/memberships/{id} Delete a membership record · Delete Membership #

Ask an LLM

“How do I delete a membership that was created by mistake?”

“Is deleting a membership different from cancelling it?”

Tell an agent destructive · confirm first

Delete membership {id}.

Permanently remove membership record {id}.

GET /provider/memberships/{id} Look up one membership and its status · Show Membership #

Ask an LLM

“What is the current status of a specific membership, active, unpaid or ended?”

“Can I see the enrollment status of one patient's membership?”

Tell an agent

Show membership {id}.

Get the status and enrollment details of membership {id}.

PATCH /provider/memberships/{id} Change an existing membership's plan or terms · Update Membership #

Ask an LLM

“How do I switch an existing membership to a different plan?”

“Can I change the billing period or rate on a membership that already exists?”

Tell an agent

Update membership {id} to plan {plan} for {membership_patients} from {start_date} with {period_in_months}-month periods.

Set membership {id} to end {end_date} on plan {plan} for {membership_patients}, start {start_date}, {period_in_months}-month periods.

GET /provider/memberships/new Build a default membership draft for an owner · New Membership #

Ask an LLM

“Can I get a pre-filled default membership for a patient before actually creating it?”

“What defaults would a new membership have for a given owner?”

Tell an agent

Build a default membership template for owner {owner}.

Show the default new-membership values for patient {owner}.

Hint Health Membership API

Operations 9

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification