Home
Providers
H1
H1
H1 (h1.co) is a New York City-based healthcare data and technology company, founded in 2017, that combines deep healthcare provider data with agentic AI to power drug development, medical and commercial engagement, care navigation, and provider and network intelligence for life sciences, pharma, health plans, and digital health organizations across the United States. Its developer-facing API is the Ribbon Health API (H1 acquired Ribbon Health), a proprietary REST API served over HTTPS at https://api.ribbonhealth.com that provides accurate, comprehensive data on healthcare providers, locations, insurances, procedures, price transparency, cost estimates, and insurance eligibility. Two OpenAPI 3.1 contracts are published - the 75-operation v1 API under /v1, and a newer 7-operation location-first Price Transparency v2 surface under /v2 that H1 tells new integrations to prefer over the legacy provider-first /v1/pricing endpoints. The API is not FHIR-based and does not expose a SMART-on-FHIR or Da Vinci PDEX Plan-Net surface; it authenticates with a bearer API key, has no OAuth scopes, and gates product families on per-account entitlement flags. It is segmented into provider, location, custom-filter, focus-area, price-transparency (v1 and v2), cost-estimate/eligibility, organization, reference-data, and network-analysis product families. Access is gated behind a request-demo / API-key sign-up rather than fully self-serve, and no pricing, plans, SDKs, sandbox, changelog or webhook surface is published.
H1 publishes 21 APIs on the APIs.io network, including Ribbon Providers API, Ribbon Locations API, Ribbon Custom Filters API, and 18 more. Tagged areas include Healthcare, United States, Life Sciences, Provider Data, and Healthcare API.
H1’s developer surface includes authentication, documentation, API reference, getting-started guide, signup flow, engineering blog, support, and 37 more developer resources.
21 APIs
1 MCP Servers
Healthcare United States Life Sciences Provider Data Healthcare API Price Transparency Eligibility Network Intelligence Digital Health Pharma
On this page
Kin Score
APIs 21
Open Collections 12
MCP Servers 1
Pricing Plans 1
Rate Limits 1
Security Posture 2
Agentic Access 1
Resources 44
apis.yml
58 Operational Transparency
Composite quality — 54.3/100 · strong
Contract Quality
13.0 / 21
Developer Ergonomics
8.4 / 17
Operational Transparency
6.4 / 11
Contract Governance
1.7 / 10
Regulatory Posture
7.3 / 15
Agent readiness — 43/100 · agent ready
Machine-Readable Contract
18 / 18
Agentic Access Contract
10 / 10
Documented Reversibility
0 / 6
MCP Server
0 / 12
Machine-Readable Auth
10 / 10
Idempotency
0 / 9
Stable Error Semantics
8 / 8
Request/Response Examples
7 / 7
Rate-Limit Signaling
7 / 7
Typed Event Surface
0 / 6
Agent Skills
5 / 5
Well-Known Catalog
0 / 4
Consent & Bot Identity
0 / 3
A2A Agent Card
0 / 8
Dry-Run / Simulate Mode
0 / 4
Individual APIs this provider publishes, each with its own machine-readable definition.
Scroll for all 21
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
Scroll for all 12
Model Context Protocol servers that expose these APIs to AI agents.
Published pricing tiers and plan structures.
Documented rate limits and quota policies.
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Recommended x-agentic-access execution contracts for AI agents.
Get Started 6
Portal, sign-up, and the first successful call
Documentation 4
Reference material describing how the API behaves
Agent Surfaces 4
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 5
Pagination, idempotency, versioning, errors, and events
Build 4
SDKs, sample code, and the tooling you integrate with
Access & Security 2
Authentication, authorization, and security posture
Operate 7
Status, limits, changes, and where to get help
Scroll for all 7
Commercial 5
Pricing, plans, and the legal terms of use
Company 4
The organization behind the API
Other 3
Properties that don't map to a standard resource type
Source (apis.yml)
aid: h1
url: https://raw.githubusercontent.com/api-evangelist/h1/refs/heads/main/apis.yml
name: H1
kind: company
description: H1 (h1.co) is a New York City-based healthcare data and technology company, founded in 2017, that combines deep
healthcare provider data with agentic AI to power drug development, medical and commercial engagement, care navigation,
and provider and network intelligence for life sciences, pharma, health plans, and digital health organizations across the
United States. Its developer-facing API is the Ribbon Health API (H1 acquired Ribbon Health), a proprietary REST API served
over HTTPS at https://api.ribbonhealth.com that provides accurate, comprehensive data on healthcare providers, locations,
insurances, procedures, price transparency, cost estimates, and insurance eligibility. Two OpenAPI 3.1 contracts are published
- the 75-operation v1 API under /v1, and a newer 7-operation location-first Price Transparency v2 surface under /v2 that
H1 tells new integrations to prefer over the legacy provider-first /v1/pricing endpoints. The API is not FHIR-based and
does not expose a SMART-on-FHIR or Da Vinci PDEX Plan-Net surface; it authenticates with a bearer API key, has no OAuth
scopes, and gates product families on per-account entitlement flags. It is segmented into provider, location, custom-filter,
focus-area, price-transparency (v1 and v2), cost-estimate/eligibility, organization, reference-data, and network-analysis
product families. Access is gated behind a request-demo / API-key sign-up rather than fully self-serve, and no pricing,
plans, SDKs, sandbox, changelog or webhook surface is published.
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
- Healthcare
- United States
- Life Sciences
- Provider Data
- Healthcare API
- Price Transparency
- Eligibility
- Network Intelligence
- Digital Health
- Pharma
created: '2026-07-24'
modified: '2026-08-15'
specificationVersion: '0.23'
apis:
- aid: h1:ribbon-providers-api
name: H1 Ribbon Providers API
description: Provider data and network intelligence keyed by NPI - retrieve and curate healthcare providers along with their
specialties, procedures, clinical areas, locations, and insurance affiliations.
humanURL: https://ribbon.readme.io/reference
baseURL: https://api.ribbonhealth.com/v1
tags:
- Providers
- Healthcare
- Provider Data
properties:
- type: OpenAPI
url: openapi/ribbon-health-api-openapi.json
- type: Documentation
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: APIReference
url: https://ribbon.readme.io/reference
- aid: h1:ribbon-locations-api
name: H1 Ribbon Locations API
description: Healthcare location data - create, read, update, and delete provider locations and manage their associated
clinical areas, insurances, and organizations.
humanURL: https://ribbon.readme.io/reference
baseURL: https://api.ribbonhealth.com/v1
tags:
- Locations
- Healthcare
properties:
- type: OpenAPI
url: openapi/ribbon-health-api-openapi.json
- type: Documentation
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: APIReference
url: https://ribbon.readme.io/reference
- aid: h1:ribbon-filters-api
name: H1 Ribbon Custom Filters API
description: Create, edit, and delete saved custom filters for providers and locations to scope and reuse queries against
the Ribbon provider and location data.
humanURL: https://ribbon.readme.io/reference
baseURL: https://api.ribbonhealth.com/v1
tags:
- Filters
- Healthcare
properties:
- type: OpenAPI
url: openapi/ribbon-health-api-openapi.json
- type: Documentation
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: APIReference
url: https://ribbon.readme.io/reference
- aid: h1:ribbon-focus-areas-api
name: H1 Ribbon Focus Areas API
description: Clinical focus-area reference data - browse clinical areas, conditions, and treatments used to describe and
match provider expertise.
humanURL: https://ribbon.readme.io/reference
baseURL: https://api.ribbonhealth.com/v1
tags:
- Focus Areas
- Clinical Areas
- Healthcare
properties:
- type: OpenAPI
url: openapi/ribbon-health-api-openapi.json
- type: Documentation
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: APIReference
url: https://ribbon.readme.io/reference
- aid: h1:ribbon-price-transparency-api
name: H1 Ribbon Price Transparency API
description: Machine-readable price-transparency data - negotiated rates by carrier, provider (NPI), procedure, and location
drawn from payer price-transparency disclosures.
humanURL: https://ribbon.readme.io/reference
baseURL: https://api.ribbonhealth.com/v1
tags:
- Price Transparency
- Pricing
- Healthcare
properties:
- type: OpenAPI
url: openapi/ribbon-health-api-openapi.json
- type: Documentation
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: APIReference
url: https://ribbon.readme.io/reference
- aid: h1:ribbon-cost-estimates-eligibility-api
name: H1 Ribbon Cost Estimates & Eligibility API
description: Procedure cost estimates and insurance eligibility - submit eligibility checks and retrieve supported eligibility
insurance partners and estimated procedure costs.
humanURL: https://ribbon.readme.io/reference
baseURL: https://api.ribbonhealth.com/v1
tags:
- Cost Estimates
- Eligibility
- Healthcare
properties:
- type: OpenAPI
url: openapi/ribbon-health-api-openapi.json
- type: Documentation
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: APIReference
url: https://ribbon.readme.io/reference
- aid: h1:ribbon-organizations-api
name: H1 Ribbon Organizations API
description: Healthcare organization records - retrieve organizations and their details used to group and affiliate providers
and locations.
humanURL: https://ribbon.readme.io/reference
baseURL: https://api.ribbonhealth.com/v1
tags:
- Organization
- Healthcare
tags_raw:
- Organizations
- Healthcare
properties:
- type: OpenAPI
url: openapi/ribbon-health-api-openapi.json
- type: Documentation
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: APIReference
url: https://ribbon.readme.io/reference
- aid: h1:ribbon-reference-data-api
name: H1 Ribbon Reference Data API
description: Shared reference data and custom taxonomies - insurances, specialties, procedures, provider types, location
types, languages, TINs, and virtual care platforms used across the Ribbon data model.
humanURL: https://ribbon.readme.io/reference
baseURL: https://api.ribbonhealth.com/v1
tags:
- Reference Data
- Insurances
- Specialties
- Healthcare
properties:
- type: OpenAPI
url: openapi/ribbon-health-api-openapi.json
- type: Documentation
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: APIReference
url: https://ribbon.readme.io/reference
- aid: h1:ribbon-network-analysis-api
name: H1 Ribbon Network Analysis API
description: Network analysis endpoint for assessing provider network composition and adequacy across the Ribbon provider
and insurance data.
humanURL: https://ribbon.readme.io/reference
baseURL: https://api.ribbonhealth.com/v1
tags:
- Networks
- Network Intelligence
- Healthcare
properties:
- type: OpenAPI
url: openapi/ribbon-health-api-openapi.json
- type: Documentation
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: APIReference
url: https://ribbon.readme.io/reference
- aid: h1:h1-insights-cost-estimates-api
name: H1 Cost Estimates API
description: The Cost Estimates API from H1 — 4 operation(s) for cost estimates.
humanURL: https://ribbon.readme.io/
baseURL: https://api.ribbonhealth.com/v1
tags:
- Cost Estimates
properties:
- type: OpenAPI
url: openapi/h1-cost-estimates-api-openapi.yml
- type: Documentation
url: https://ribbon.readme.io/
- type: APIReference
url: https://ribbon.readme.io/reference/getcustomproviders
- type: GettingStarted
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: Authentication
url: https://ribbon.readme.io/docs/authentication
- type: ToolCrosswalk
url: mcp/h1-tool-crosswalk.yml
- aid: h1:h1-insights-filters-api
name: H1 Filters API
description: The Filters API from H1 — 4 operation(s) for filters.
humanURL: https://ribbon.readme.io/
baseURL: https://api.ribbonhealth.com/v1
tags:
- Filters
properties:
- type: OpenAPI
url: openapi/h1-filters-api-openapi.yml
- type: Documentation
url: https://ribbon.readme.io/
- type: APIReference
url: https://ribbon.readme.io/reference/getcustomproviders
- type: GettingStarted
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: Authentication
url: https://ribbon.readme.io/docs/authentication
- type: ToolCrosswalk
url: mcp/h1-tool-crosswalk.yml
- aid: h1:h1-insights-focus-area-endpoints-api
name: H1 Focus Area Endpoints API
description: The Focus Area Endpoints API from H1 — 6 operation(s) for focus area endpoints.
humanURL: https://ribbon.readme.io/
baseURL: https://api.ribbonhealth.com/v1
tags:
- Focus Area Endpoints
properties:
- type: OpenAPI
url: openapi/h1-focus-area-endpoints-api-openapi.yml
- type: Documentation
url: https://ribbon.readme.io/
- type: APIReference
url: https://ribbon.readme.io/reference/getcustomproviders
- type: GettingStarted
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: Authentication
url: https://ribbon.readme.io/docs/authentication
- type: ToolCrosswalk
url: mcp/h1-tool-crosswalk.yml
- aid: h1:h1-insights-locations-api
name: H1 Locations API
description: The Locations API from H1 — 5 operation(s) for locations.
humanURL: https://ribbon.readme.io/
baseURL: https://api.ribbonhealth.com/v1
tags:
- Locations
properties:
- type: OpenAPI
url: openapi/h1-locations-api-openapi.yml
- type: Documentation
url: https://ribbon.readme.io/
- type: APIReference
url: https://ribbon.readme.io/reference/getcustomproviders
- type: GettingStarted
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: Authentication
url: https://ribbon.readme.io/docs/authentication
- type: ToolCrosswalk
url: mcp/h1-tool-crosswalk.yml
- aid: h1:h1-insights-networks-api
name: H1 Networks API
description: The Networks API from H1 — 1 operation(s) for networks.
humanURL: https://ribbon.readme.io/
baseURL: https://api.ribbonhealth.com/v1
tags:
- Networks
properties:
- type: OpenAPI
url: openapi/h1-networks-api-openapi.yml
- type: Documentation
url: https://ribbon.readme.io/
- type: APIReference
url: https://ribbon.readme.io/reference/getcustomproviders
- type: GettingStarted
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: Authentication
url: https://ribbon.readme.io/docs/authentication
- type: ToolCrosswalk
url: mcp/h1-tool-crosswalk.yml
- aid: h1:h1-insights-organizations-api
name: H1 Organizations API
description: The Organizations API from H1 — 2 operation(s) for organizations.
humanURL: https://ribbon.readme.io/
baseURL: https://api.ribbonhealth.com/v1
tags:
- Organization
tags_raw:
- Organizations
properties:
- type: OpenAPI
url: openapi/h1-organizations-api-openapi.yml
- type: Documentation
url: https://ribbon.readme.io/
- type: APIReference
url: https://ribbon.readme.io/reference/getcustomproviders
- type: GettingStarted
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: Authentication
url: https://ribbon.readme.io/docs/authentication
- type: ToolCrosswalk
url: mcp/h1-tool-crosswalk.yml
- aid: h1:h1-insights-price-transparency-api
name: H1 Price Transparency API
description: The Price Transparency API from H1 — 8 operation(s) for price transparency.
humanURL: https://ribbon.readme.io/
baseURL: https://api.ribbonhealth.com/v1
tags:
- Price Transparency
properties:
- type: OpenAPI
url: openapi/h1-price-transparency-api-openapi.yml
- type: Documentation
url: https://ribbon.readme.io/
- type: APIReference
url: https://ribbon.readme.io/reference/getcustomproviders
- type: GettingStarted
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: Authentication
url: https://ribbon.readme.io/docs/authentication
- type: ToolCrosswalk
url: mcp/h1-tool-crosswalk.yml
- aid: h1:h1-insights-providers-api
name: H1 Providers API
description: The Providers API from H1 — 10 operation(s) for providers.
humanURL: https://ribbon.readme.io/
baseURL: https://api.ribbonhealth.com/v1
tags:
- Providers
properties:
- type: OpenAPI
url: openapi/h1-providers-api-openapi.yml
- type: Documentation
url: https://ribbon.readme.io/
- type: APIReference
url: https://ribbon.readme.io/reference/getcustomproviders
- type: GettingStarted
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: Authentication
url: https://ribbon.readme.io/docs/authentication
- type: ToolCrosswalk
url: mcp/h1-tool-crosswalk.yml
- aid: h1:h1-insights-reference-endpoints-api
name: H1 Reference Endpoints API
description: The Reference Endpoints API from H1 — 13 operation(s) for reference endpoints.
humanURL: https://ribbon.readme.io/
baseURL: https://api.ribbonhealth.com/v1
tags:
- Reference Endpoints
properties:
- type: OpenAPI
url: openapi/h1-reference-endpoints-api-openapi.yml
- type: Documentation
url: https://ribbon.readme.io/
- type: APIReference
url: https://ribbon.readme.io/reference/getcustomproviders
- type: GettingStarted
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: Authentication
url: https://ribbon.readme.io/docs/authentication
- type: ToolCrosswalk
url: mcp/h1-tool-crosswalk.yml
- aid: h1:h1-insights-tins-api
name: H1 TI Ns API
description: The TINs API from H1 — 2 operation(s) for tins.
humanURL: https://ribbon.readme.io/
baseURL: https://api.ribbonhealth.com/v1
tags:
- TINs
properties:
- type: OpenAPI
url: openapi/h1-tins-api-openapi.yml
- type: Documentation
url: https://ribbon.readme.io/
- type: APIReference
url: https://ribbon.readme.io/reference/getcustomproviders
- type: GettingStarted
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: Authentication
url: https://ribbon.readme.io/docs/authentication
- type: ToolCrosswalk
url: mcp/h1-tool-crosswalk.yml
- aid: h1:h1-insights-virtual-care-platforms-api
name: H1 Virtual Care Platforms API
description: The Virtual Care Platforms API from H1 — 2 operation(s) for virtual care platforms.
humanURL: https://ribbon.readme.io/
baseURL: https://api.ribbonhealth.com/v1
tags:
- Virtual Care Platforms
properties:
- type: OpenAPI
url: openapi/h1-virtual-care-platforms-api-openapi.yml
- type: Documentation
url: https://ribbon.readme.io/
- type: APIReference
url: https://ribbon.readme.io/reference/getcustomproviders
- type: GettingStarted
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: Authentication
url: https://ribbon.readme.io/docs/authentication
- type: ToolCrosswalk
url: mcp/h1-tool-crosswalk.yml
- aid: h1:h1-price-transparency-v2-api
name: H1 Price Transparency v2 API
description: Location-first negotiated-rate API under /v2/* - resolve procedures, care clusters and carriers, then shop
procedure-level and care-cluster (bundle) prices at a known facility or near an address / lat-lng, returned cheapest-first
in a single shared response envelope. Separate from, and preferred over, the legacy provider-first /v1/pricing/* endpoints;
gated on the doctors.can_price_transparency account entitlement.
humanURL: https://ribbon.readme.io/reference/getv2procedures
baseURL: https://api.ribbonhealth.com
tags:
- Price Transparency
- Pricing
- Care Clusters
- Healthcare
properties:
- type: OpenAPI
url: openapi/h1-price-transparency-v2-openapi.json
- type: Overlay
url: overlays/h1-price-transparency-v2-overlay.yaml
- type: Documentation
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: APIReference
url: https://ribbon.readme.io/reference/getv2procedures
- type: Authentication
url: https://ribbon.readme.io/docs/authentication
- type: AgentSkill
url: skills/h1-shop-prices-near-me-v2.md
- type: ToolCrosswalk
url: mcp/h1-tool-crosswalk.yml
common:
- type: Plans
url: plans/h1-plans-pricing.yml
- type: Overlay
url: overlays/h1-price-transparency-v2-overlay.yaml
- type: AgenticAccess
url: agentic-access/h1-agentic-access.yml
- type: DomainSecurity
url: security/h1-domain-security.yml
- type: Authentication
url: authentication/h1-authentication.yml
- type: RateLimits
url: rate-limits/h1-rate-limits.yml
- type: Conventions
url: conventions/h1-conventions.yml
- type: ErrorCatalog
url: errors/h1-problem-types.yml
- type: Lifecycle
url: lifecycle/h1-lifecycle.yml
- type: StatusPage
url: https://status.ribbonhealth.com
- type: Conformance
url: conformance/h1-conformance.yml
- type: DataModel
url: data-model/h1-data-model.yml
- type: MCPServer
url: mcp/h1-mcp.yml
- type: ToolCrosswalk
url: mcp/h1-tool-crosswalk.yml
- type: Overlay
url: overlays/h1-ribbon-health-api-overlay.yaml
- type: AgentSkill
url: skills/_index.yml
- type: LLMsTxt
url: llms/h1-llms.txt
- type: GitHubOrganization
url: https://github.com/RibbonHealth
- type: Website
url: https://h1.co/
- type: DeveloperPortal
url: https://ribbon.readme.io/
- type: Documentation
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: APIReference
url: https://ribbon.readme.io/reference
- type: GettingStarted
url: https://ribbon.readme.io/docs/getting-started
- type: SignUp
url: https://h1.co/request-demo/
- type: Blog
url: https://h1.co/blog/
- type: Support
url: https://h1.co/contact/
- type: TermsOfService
url: https://h1.co/terms-of-use/
- type: PrivacyPolicy
url: https://h1.co/privacy-policy/
- type: Website
url: https://h1.com/
- type: Documentation
url: https://ribbon.readme.io/
- type: APIReference
url: https://ribbon.readme.io/reference/getcustomproviders
- type: GettingStarted
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: Support
url: https://h1.com/company/contact-us/
- type: HelpCenter
url: https://support.h1.co/hc/en-us
- type: Blog
url: https://h1.com/blog/
- type: GitHubOrganization
url: https://github.com/h1insights
- type: SignUp
url: https://h1.com/request-demo/
- type: Login
url: https://app.h1insights.com/login
- type: TermsOfService
url: https://h1.com/terms-of-use/
- type: PrivacyPolicy
url: https://h1.com/privacy-policy/
- type: StatusPage
url: https://status.ribbonhealth.com/
- type: Deprecation
url: lifecycle/h1-lifecycle.yml
- type: Packages
url: packages/h1-packages.yml
- type: Overlay
url: overlays/h1-openapi-overlay.yaml
maintainers:
- FN: Kin Lane
email: kin@apievangelist.com
x-enrichment:
date: '2026-08-15'
status: enriched
artifacts_added: 4
pass: local-v1
x-coverage:
state: covered
reason: null
detail: Fully readable. Two OpenAPI 3.1 contracts were harvested from H1's own hosts, a verbatim llms.txt is served at https://ribbon.readme.io/llms.txt,
and every remaining absence (no plans, no SDKs, no changelog, no sandbox, no webhooks/AsyncAPI, no /.well-known documents,
no agent card, no compliance program) was probed and recorded rather than assumed.
checked: '2026-08-15'