Overview
Hint powers over 2,500 Direct Primary Care practices with software built to streamline operations and enable better patient care. This API gives you programmatic access to the same capabilities - from patient enrollment and membership billing to practice configuration and partner integrations.
Choose your path
| Audience | Description | Start here |
|---|---|---|
| Integration partners | Build integrations that can be activated by many practices through the Hint Marketplace | Join the Hint Marketplace |
| Practice developers | Automate workflows for a single practice (practice staff, consultants, in-house devs) | Making Requests |
Practice API AccessTo request Practice API Access, contact [email protected]. This requires approval from a practice admin.
Platform fundamentals
- Every request uses HTTPS with Bearer tokens. Review Making Requests for headers, pagination, and rate limits.
- Most work happens via
/api/provider/*endpoints using a practice-specific access token. Partner-level setup (OAuth, webhooks, integration metadata) uses your Partner API key. - Hint provides both Production (
api.hint.com) and Sandbox (api.staging.hint.com) environments with separate credentials. - Webhooks are the primary push channel. Configure them once per partner to capture lifecycle events across every connected practice (Webhooks).
Resource namespaces
| Scope | Endpoints | Typical actions | Auth |
|---|---|---|---|
| Practice data | /api/provider/* | Work with patients, memberships, invoices, practitioners, practice configuration | Practice-specific access token |
| Partner setup | /api/oauth/*, /api/integrations, webhooks | OAuth token exchange, integration metadata, webhook configuration | Partner API key |
Practice resources (Provider endpoints)
Practice resources expose PHI and practice-level configuration via /api/provider/*. You must keep one access token per practice and rotate them per your compliance program. Use these endpoints to:
- create or update patients, memberships, and invoices
- sync practice configuration data such as pricing, consent, or staff rosters
- trigger operational workflows (e.g., charge creation, refunds)
Partner resources
Partner resources define how Hint recognizes and reaches your integration across every practice. Use your Partner API key to:
- exchange OAuth authorization codes for practice access tokens
- publish integration metadata (names, instructions, support contacts)
- register and verify webhook delivery targets
See Partner Endpoints for the full reference.
Updated about 10 hours ago