H1 website screenshot

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/v1 that provides accurate, comprehensive data on healthcare providers, locations, insurances, procedures, price transparency, cost estimates, and insurance eligibility. The API is not FHIR-based and does not expose a SMART-on-FHIR surface; it authenticates with a bearer API key and is segmented into provider, location, custom-filter, focus-area, price-transparency, 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.

H1 publishes 9 APIs on the APIs.io network, including Ribbon Providers API, Ribbon Locations API, Ribbon Custom Filters API, and 6 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 20 more developer resources.

🌐 Visit website 📡 Source on GitHub
48.9/100 developing ▬ flat Agent 72/100 agent native Full breakdown ↓
scored 2026-07-27 · rubric v0.5
9 APIs 1 MCP Servers
HealthcareUnited StatesLife SciencesProvider DataHealthcare APIPrice TransparencyEligibilityNetwork IntelligenceDigital HealthPharma

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 48.9/100 · developing
Contract Quality 9.4 / 25
Developer Ergonomics 13.5 / 20
Commercial Clarity 6.8 / 20
Operational Transparency 8.2 / 13
Governance 0.0 / 12
Discoverability 10.0 / 10
Agent readiness — 72/100 · agent native
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 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
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/h1: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 9

Individual APIs this provider publishes, each with its own machine-readable definition.

H1 Ribbon Providers API

Provider data and network intelligence keyed by NPI - retrieve and curate healthcare providers along with their specialties, procedures, clinical areas, locations, and insurance...

H1 Ribbon Locations API

Healthcare location data - create, read, update, and delete provider locations and manage their associated clinical areas, insurances, and organizations.

H1 Ribbon Custom Filters API

Create, edit, and delete saved custom filters for providers and locations to scope and reuse queries against the Ribbon provider and location data.

H1 Ribbon Focus Areas API

Clinical focus-area reference data - browse clinical areas, conditions, and treatments used to describe and match provider expertise.

H1 Ribbon Price Transparency API

Machine-readable price-transparency data - negotiated rates by carrier, provider (NPI), procedure, and location drawn from payer price-transparency disclosures.

H1 Ribbon Cost Estimates & Eligibility API

Procedure cost estimates and insurance eligibility - submit eligibility checks and retrieve supported eligibility insurance partners and estimated procedure costs.

H1 Ribbon Organizations API

Healthcare organization records - retrieve organizations and their details used to group and affiliate providers and locations.

H1 Ribbon Reference Data API

Shared reference data and custom taxonomies - insurances, specialties, procedures, provider types, location types, languages, TINs, and virtual care platforms used across the Ri...

H1 Ribbon Network Analysis API

Network analysis endpoint for assessing provider network composition and adequacy across the Ribbon provider and insurance data.

Scroll for all 9

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

h1-mcp.yml

MCP SERVER

Rate Limits 1

Documented rate limits and quota policies.

H1 Rate Limits

8 limits

RATE LIMITS

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

H1 Authentication

http · 1 scheme

SECURITY

H1 Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

H1 Agentic Access

75 operations · 34 acting

75 operations · 34 acting

AGENTIC

Resources

Get Started 3

Portal, sign-up, and the first successful call

DeveloperPortal
DeveloperPortal
 GettingStarted
GettingStarted
 SignUp
SignUp

Documentation 2

Reference material describing how the API behaves

Documentation
Documentation
 APIReference
APIReference

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess
 MCPServer
MCPServer
 AgentSkill
AgentSkill
 LLMsTxt
LLMsTxt

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Conventions
Conventions
 ErrorCatalog
ErrorCatalog
 Lifecycle
Lifecycle
 Conformance
Conformance
 DataModel
DataModel

Build 2

SDKs, sample code, and the tooling you integrate with

ToolCrosswalk
ToolCrosswalk
 GitHubOrganization
GitHubOrganization

Access & Security 3

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication
 Security
Security

Operate 3

Status, limits, changes, and where to get help

RateLimits
RateLimits
 StatusPage
StatusPage
 Support
Support

Commercial 2

Pricing, plans, and the legal terms of use

TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy

Company 2

The organization behind the API

Website
Website
 Blog
Blog

Other 1

Properties that don't map to a standard resource type

Overlay
Overlay

Source (apis.yml)

apis.yml Raw ↑ 
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/v1 that provides accurate, comprehensive data on healthcare providers, locations,
  insurances, procedures, price transparency, cost estimates, and insurance eligibility. The API is not FHIR-based and does
  not expose a SMART-on-FHIR surface; it authenticates with a bearer API key and is segmented into provider, location, custom-filter,
  focus-area, price-transparency, 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.
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-07-24'
specificationVersion: '0.19'
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:
  - 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
common:
- 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: Security
  url: https://h1.co/security/
- type: TermsOfService
  url: https://h1.co/terms-of-use/
- type: PrivacyPolicy
  url: https://h1.co/privacy-policy/
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com