# HealthSherpa ❮ONE❯ Developer Portal

> HealthSherpa ❮ONE❯ gives developers access to ACA quoting APIs and approval-gated enrollment workflows through public docs, self-serve registration, and a passwordless developer portal.

The canonical public portal is `https://one.healthsherpa.com/`. Public quoting APIs are available after signup. Enrollment workflows require additional review and approval. API authentication uses the `x-api-key` header.

This file is the curated LLM entrypoint for Context7 and other documentation crawlers. Prefer the Markdown and OpenAPI links below over crawling rendered HTML pages.

## Primary LLM Context

- [Full LLM context](https://one.healthsherpa.com/llms-full.txt): Consolidated public developer documentation for AI assistants and LLM crawlers.

## Public Documentation

- [Developer portal overview](https://one.healthsherpa.com/index.html.md): Platform overview, current capabilities, onboarding flow, planned work, and compatibility notes.
- [API documentation](https://one.healthsherpa.com/docs.html.md): Endpoint reference for `GET /v1/ping`, `GET /v1/reference/counties`, `GET /v1/reference/issuers`, `POST /v1/quotes`, and the approval-gated `POST /v1/enrollment-sessions`, plus approval-gated enrollment workflow summaries.
- [Vibe coding guide](https://one.healthsherpa.com/vibe-coders.html.md): Secure copy/paste prompts for app builders, API key handling rules, and starter workflow guidance.
- [OpenAPI specification](https://one.healthsherpa.com/openapi.json): OpenAPI 3.1 contract for the currently available public endpoints.

## Access And Key Management

- [Get your API key](https://one.healthsherpa.com/register.html.md): Registration, email verification, and self-serve developer access flow.
- [Portal login and key management](https://one.healthsherpa.com/portal.html.md): Passwordless sign-in, one-time API key reveal, key confirmation, and approval-gated access request workflow.

## Current Public API Surface

- `GET /v1/ping`: Confirm API reachability and key validity.
- `GET /v1/reference/counties`: Resolve ZIP code to county options and FIPS codes.
- `GET /v1/reference/issuers`: List active QHP issuers in a state for a plan year (`name`, `hios_issuer_id`); `plan_year` defaults to the current ACA plan year.
- `POST /v1/quotes`: Request ACA plan quotes for the selected coverage type and household.
- `POST /v1/enrollment-sessions` (approval required): Create HealthSherpa links (`shopping_url`, `client_apply_url`) that send the browser to a hosted enrollment flow for on-exchange ACA medical plans. Request portal access at `https://one.healthsherpa.com/portal.html`. Runtime `403 forbidden` is flow-scoped: `agent_assisted` requires a healthy Marketplace OAuth link; `self_service` requires approved D2C deep-link access and a configured agent ID. See `llms-full.txt` or the OpenAPI `POST /v1/enrollment-sessions` `403` response for the full matrix.

## Vibe Coding Prompt Files

- [Google AI Studio prompt](https://one.healthsherpa.com/prompts/google-ai-studio-healthquote-pro.md)
- [Claude skill prompt](https://one.healthsherpa.com/prompts/claude-hs-one.skill)
- [Codex prompt](https://one.healthsherpa.com/prompts/codex-healthquote-pro.md)
- [Lovable prompt](https://one.healthsherpa.com/prompts/lovable-healthquote-pro.md)
- [Replit prompt](https://one.healthsherpa.com/prompts/replit-healthquote-pro.md)

## Compatibility Rules

- Response objects are intentionally open and may gain new optional fields.
- Clients should ignore unknown response properties.
- Clients should not rely on object property order.

## Crawl Guidance

- Crawl only public portal docs, Markdown mirrors, and `openapi.json`.
- Do not infer behavior from private repository planning docs or internal RFCs.
- Treat approval-gated enrollment workflows as not generally available without review.

## Contact

- [Developer support](mailto:developers@one.healthsherpa.com): Contact for developer onboarding and portal access questions.
- [Human-readable public docs](https://one.healthsherpa.com/docs.html): Browser-oriented documentation page.
- [HealthSherpa website](https://www.healthsherpa.com): Company website.