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 12 APIs on the APIs.io network, including Cost Estimates API, Filters API, Focus Area Endpoints API, and 9 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 39 more developer resources.
3 APIs
On this page
Kin Score
APIs 12
Open Collections 12
Pricing Plans 1
Rate Limits 1
Security Posture 2
Agentic Access 1
Resources 46
apis.yml
58 Operational Transparency
0 Create-or-Update Ergonomics
Composite quality — 51.7/100 · developing
Agent readiness — 32/100 · agent ready
Individual APIs this provider publishes, each with its own machine-readable definition.
Scroll for all 12
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
Scroll for all 12
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 5
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 4
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.
deliveryModel:
model: saas
open_source: false
commercial: true
callable_host: true
label: Hosted service · you call their endpoint
confidence: high
source:
- openapi
- pricing
generated: '2026-08-28'
method: derived
accessModel:
pricing: unknown
onboarding: approval
trial: false
try_now: false
public: false
label: Requires approval
confidence: medium
source:
- plans
- authentication
- rate-limits
- security
generated: '2026-09-03'
method: derived
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: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 rates under `/v2/*`. Prefer these endpoints for new
integrations. Carrier ids come from `GET /v2/carriers` and are not interchangeable
with v1 pricing carrier UUIDs. Provider-scoped v2 routes are not live yet.'
humanURL: https://ribbon.readme.io/reference
baseURL: https://api.ribbonhealth.com/v1
tags:
- Price Transparency v2
properties:
- type: OpenAPI
url: openapi/h1-price-transparency-v2-api-openapi.yml
- type: Documentation
url: https://ribbon.readme.io/docs/welcome-to-the-ribbon-health-api
- type: APIReference
url: https://ribbon.readme.io/reference
- type: APIReference
url: https://ribbon.readme.io/reference/getv2procedures
- type: Authentication
url: https://ribbon.readme.io/docs/authentication
- type: ToolCrosswalk
url: mcp/h1-tool-crosswalk.yml
common:
- type: CapabilityMap
url: capabilities/h1-capability-edges.yml
name: H1 Business Capability Map
- type: AgentSkill
url: skills/h1-shop-prices-near-me-v2.md
- 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: X-MCPServerCandidate
url: mcp/h1-mcp.yml
note: 'Renamed from MCPServer 2026-09-03 (roadmap#247): the manifest self-describes as status: candidate — a tool list derived
from the published API contracts, not an existing server. The scorer already read the manifest and reported mcp_server
correctly; the MCPServer type was crediting the artifact-type surfaces with a server that does not exist.'
- 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'
Every provider here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for providers
9 MCP tools reach this
find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This provider
curl "https://apis.io/api/v1/providers/h1"
All providers
curl "https://apis.io/api/v1/providers?limit=25"
Every operation they expose
curl "https://apis.io/api/v1/providers/h1/operations?limit=25"
How their score was established
curl "https://apis.io/api/v1/providers/h1/evidence"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms .
A second provider on the same verified email joins the account you already have.