# InPlan > InPlan is an API that tells your product which marketplace and Medicare Advantage plans list a provider, with the source type and the date behind every answer. Base URL: https://api.inplan.io. Auth: `Authorization: Bearer `. Answers: `in_network: true` (answer `listed`) means the plan's network directory lists the provider, with evidence. `in_network: null` (answer `not_found`) means no listing was found in current directory data; it is not a statement that the provider is out of network. ## Get started - [InPlan docs](https://inplan.io/docs.md): Documentation for the InPlan API: check whether a plan lists a provider, read the evidence, and handle limits and errors. - [Quickstart](https://inplan.io/docs/quickstart.md): Get an InPlan key, check one provider against one plan, read the answer and its evidence, then check many pairs in one call. - [Authentication](https://inplan.io/docs/authentication.md): Authenticate InPlan API requests with a bearer key in the Authorization header. Key format, server-side use and 401 responses. - [Keys and the demo key](https://inplan.io/docs/keys.md): Create, rotate and revoke InPlan API keys, and what the Playground demo key can do. - [Rate limits and quotas](https://inplan.io/docs/rate-limits.md): InPlan rate limits and monthly quotas: the RateLimit and X-Quota headers, what counts as a call, and how to handle 429 responses. ## Concepts - [Answers and evidence](https://inplan.io/docs/answers-and-evidence.md): How to read an InPlan answer: listed, not_found and no_provider_network, in_network true or null, the evidence block and its source and dates. - [Plans and plan years](https://inplan.io/docs/plans-and-plan-years.md): InPlan plan ids for marketplace and Medicare Advantage plans, variants, plan years and the year parameter. - [Providers and NPIs](https://inplan.io/docs/providers-and-npis.md): NPIs in the InPlan API: the check digit, provider profiles, names and credentials, practice locations and privacy. - [Data freshness](https://inplan.io/docs/data-freshness.md): How current InPlan data is: as_of dates on every listing, data_as_of on every response, and the dates in /v1/status. - [Batch checks](https://inplan.io/docs/batch-checks.md): Check up to 100 provider-plan pairs in one InPlan call: the items body, per-item errors, counting and limits. - [Pagination](https://inplan.io/docs/pagination.md): Paging through InPlan lists: offset and limit for a provider's plans, cursors for a plan's providers. ## Guides - [Guide: benefits and ICHRA](https://inplan.io/docs/guides/benefits.md): Check every employee's doctors against the plans on offer with InPlan batch checks, and show which plans list each doctor. - [Guide: telehealth and navigation](https://inplan.io/docs/guides/telehealth.md): Confirm that a plan lists a clinician before you book a visit, with one InPlan check, and read new-patient flags for Medicare Advantage plans. - [Guide: brokers and agents](https://inplan.io/docs/guides/brokers.md): Quote the plans that keep a client's doctors: list every plan that lists each doctor with InPlan, then intersect the lists. - [Guide: health tech platforms](https://inplan.io/docs/guides/health-tech.md): Add plan network status to provider search, matching and intake with InPlan: profiles, plan lists and plan-to-provider search. ## API reference - [API reference](https://inplan.io/docs/api.md): InPlan API reference: base URL, authentication, the response envelope and all 8 endpoints. - [Errors](https://inplan.io/docs/errors.md): Every InPlan API error: RFC 7807 problem+json fields, HTTP statuses and each problem type with what to do. - [Data dictionary](https://inplan.io/docs/data-dictionary.md): Every field the InPlan API returns, by endpoint, with its type and meaning. Generated from the API schema and real responses. - [Versioning](https://inplan.io/docs/versioning.md): How the InPlan API is versioned: the /v1 path, additive changes, the changelog and the running version. - [Provider profile](https://inplan.io/docs/api/providers.md): GET /v1/providers/{npi}: a provider profile from national registry records, with counts of the marketplace and Medicare Advantage plans that list the provider. - [Plans that list a provider](https://inplan.io/docs/api/provider-plans.md): GET /v1/providers/{npi}/plans: every marketplace and Medicare Advantage plan whose directory lists the provider, with filters and paging. - [Check a provider and plan](https://inplan.io/docs/api/check.md): GET /v1/check: does this plan's network directory list this provider? The answer comes with its evidence: plan year, network tier, source type and date. - [Batch check](https://inplan.io/docs/api/check-batch.md): POST /v1/check/batch: check up to 100 provider-plan pairs in one call, with per-item errors. Builder plan and up. - [Plan details](https://inplan.io/docs/api/plans.md): GET /v1/plans/{plan_id}: plan details for a marketplace or Medicare Advantage plan, its plan years and whether we hold its provider listings. - [Providers in a plan](https://inplan.io/docs/api/plan-providers.md): GET /v1/plans/{plan_id}/providers: page through the providers a marketplace plan lists, filtered by state, ZIP and radius, or specialty. Growth plan and up. - [Coverage](https://inplan.io/docs/api/coverage.md): GET /v1/coverage: the markets, states, insurers and plans we hold provider listings for, with the date of each. - [Status](https://inplan.io/docs/api/status.md): GET /v1/status: API health and the date of each data source. No key needed, not counted against quota. ## AI agents - [MCP server for AI agents](https://inplan.io/docs/mcp.md): Connect Claude, Cursor and other AI agents to InPlan with the remote MCP server at https://api.inplan.io/mcp: endpoint, API key, the 7 tools and setup for each client. ## Files for tools - [OpenAPI 3.1](https://inplan.io/openapi.json): the full API description with real response examples - [MCP server](https://api.inplan.io/mcp): remote MCP endpoint (Streamable HTTP) with 7 tools; send `Authorization: Bearer `. Setup: https://inplan.io/docs/mcp - [Postman collection](https://inplan.io/docs/inplan.postman_collection.json): every endpoint with sample values - [All docs in one file](https://inplan.io/llms-full.txt) - [Pricing](https://inplan.io/pricing.md): plans, limits and prices - [API status](https://api.inplan.io/v1/status): health and data dates, no key needed ## Optional - [Support](https://inplan.io/docs/support.md): contact@inplan.io - [Changelog](https://inplan.io/changelog)