Guide: telehealth and navigation
Before you book, check that the member's plan lists the clinician. One call answers, with the date of the directory behind it.
Check before you book
Send the clinician's NPI and the member's plan id to GET /v1/check. Add year when the visit falls in a known plan year.
curl https://api.inplan.io/v1/check \ -H "Authorization: Bearer $INPLAN_KEY" \ -G -d npi=1184617268 -d plan_id=H2526-001-000
Read the new-patient flag
For Medicare Advantage plans, evidence[].accepting_new_patients says whether the directory marks the clinician as open to new patients. It is null when the directory does not say.
200 OK · shortened
{ "data": { "answer": "listed", "evidence": [ { "plan_id": "H2526-001-000", "plan_year": 2027, "accepting_new_patients": true, "provider_kind": "practitioner", "source": { "type": "plan_directory", "as_of": "2026-10-29" } } ] }}
Route on the answer
listed: book, and show the plan year and date in the confirmation.not_found: offer the visit with a note to confirm coverage with the plan, or offer a clinician whose answer islisted.- To find clinicians a marketplace plan lists near the member, use
GET /v1/plans/{plan_id}/providerswithzipandradius(Growth and above).
Docs / Guides / Telehealth and navigationNext: Guide: brokers and agents