Getting Started

Welcome to the H1 API!

Whether you're new here or building on an existing implementation, we're excited to help you get started!

We built H1 to simplify healthcare decisions. H1 provides the most accurate and comprehensive data on providers, plans, and healthcare costs. Our goal is to enable your team to build a seamless and effective care navigation solution for your users.

To this goal, we have built extensive documentation to help you better understand H1’s data and API. The documentation is split into two sections: Guides and API Reference. Below, we will go through how your team should use both of these sections.

If you haven't gotten an API key yet, please sign up at [<https://h1.co/request-demo/](https://h1.co/request-demo/)


Guides

H1’s guides provide a comprehensive overview of our data and help you understand how to build complete workflows using individual API endpoints. These guides are split up into a few sections:


  1. H1 Data: Interpreting H1 data and our different product modules
  2. Workflow Guides: Common workflows/use cases for using H1’s API
  3. API Information: Limitations and optimizations of H1’s API

API Reference

Want to understand how to structure individual API requests? The API Reference section provides a detailed deep dive into implementing specific endpoints within H1’s API. If you're currently building an integration and want to understand how to apply the right parameters to a search request or use the reference endpoints, this is for you! This section is split up by endpoint:

  1. Providers: <https://api.ribbonhealth.com/v1/custom/providers>
  2. Filters: <https://api.ribbonhealth.com/v1/custom/providers/filters>
  3. Locations: <https://api.ribbonhealth.com/v1/custom/locations>
  4. Reference Endpoints: Using the reference endpoints (across /insurances, /specialties, /location_types, /procedures)
  5. Focus Areas: <https://api.ribbonhealth.com/v1/custom/clinical_areas>
  6. Organizations: <https://api.ribbonhealth.com/v1/custom/organizations>
  7. Price Transparency: <https://api.ribbonhealth.com/v1/pricing/providers>
  8. Eligibility: <https://api.ribbonhealth.com/v1/eligibility>