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