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 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.

54.3/100 strong ▬ flat Agent 43/100 agent ready Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0
21 APIs 1 MCP Servers
HealthcareUnited StatesLife SciencesProvider DataHealthcare APIPrice TransparencyEligibilityNetwork IntelligenceDigital HealthPharma

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0
Composite quality — 54.3/100 · strong
Contract Quality 13.0 / 21
Developer Ergonomics 8.4 / 17
Access Clarity 5.8 / 17
Operational Transparency 6.4 / 11
Contract Governance 1.7 / 10
Discoverability 6.9 / 9
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
Regulatory Posture applies to this provider. Its tags matched the Health regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.
The six quality facets above are damped to 85 points between them, because the conditional facet above carries the other 15. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 85% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.
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 21

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.

H1 Cost Estimates API

The Cost Estimates API from H1 — 4 operation(s) for cost estimates.

H1 Filters API

The Filters API from H1 — 4 operation(s) for filters.

H1 Focus Area Endpoints API

The Focus Area Endpoints API from H1 — 6 operation(s) for focus area endpoints.

H1 Locations API

The Locations API from H1 — 5 operation(s) for locations.

H1 Networks API

The Networks API from H1 — 1 operation(s) for networks.

H1 Organizations API

The Organizations API from H1 — 2 operation(s) for organizations.

H1 Price Transparency API

The Price Transparency API from H1 — 8 operation(s) for price transparency.

H1 Providers API

The Providers API from H1 — 10 operation(s) for providers.

H1 Reference Endpoints API

The Reference Endpoints API from H1 — 13 operation(s) for reference endpoints.

H1 TI Ns API

The TINs API from H1 — 2 operation(s) for tins.

H1 Virtual Care Platforms API

The Virtual Care Platforms API from H1 — 2 operation(s) for virtual care platforms.

H1 Price Transparency v2 API

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 o...

Scroll for all 21

Open Collections 12

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Ribbon Health Filters API

OPEN COLLECTION

Ribbon Health TI Ns API

OPEN COLLECTION

Ribbon Health API

OPEN COLLECTION

Scroll for all 12

MCP Servers 1

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

H1 MCP Server

MCP SERVER

Pricing Plans 1

Published pricing tiers and plan structures.

H1 Plans Pricing

0 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

H1 Rate Limits

9 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

232 operations · 102 acting

232 operations · 102 acting

AGENTIC

Resources

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)

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 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'