NEWMedicare Advantage 2027 plans are live in the API.Read the changelog
Telehealth · care navigation · scheduling

Confirm the plan lists the clinician before you book.

One check between “choose a time” and “confirm”. Typical responses take under 50 ms, so the check fits inside the click.

Telehealth and navigation: an illustrative booking screen, Contoso Care, for clinician Michael Williard, MD, Orthopedic Surgery, plan Devoted Core 001 OH (HMO). A green line says this plan lists the clinician, accepting new patients, read on 2026-10-29.
The question at the moment of booking

“Does this patient's plan list this clinician, and as of when?”

Care teams match a patient to the right clinician by specialty, language and availability. The plan question often comes last, and by then the patient has picked a time.

InPlan moves that question to the front. Your scheduler asks it once, gets a plain answer with a date, and records it with the appointment.

Four moments in a booking, four calls.

  1. 01Intake
    The patient picks their plan. You confirm the plan name and plan year on screen.GET /v1/plans/{plan_id}
  2. 02Match
    You narrow your clinician list to the ones the patient's marketplace plan lists, then rank by your own rules.GET /v1/plans/{plan_id}/providers
  3. 03Confirm
    Right before the booking is saved, you check the exact clinician and plan pair once more.GET /v1/check?npi=…&plan_id=…
  4. 04Record
    You save the request ID and the read date with the appointment, so anyone can see what was checked and when.request_id · evidence[].source.as_of
Step 03 · Confirm
curl https://api.inplan.io/v1/check \
  -H "Authorization: Bearer $INPLAN_KEY" \
  -G -d npi=1184617268 -d plan_id=H2526-001-000
{
  "in_network": true,
  "answer": "listed",
  "plan_year": 2027,
  "plan": { "plan_name": "DEVOTED CHOICE 001 OH (PPO)" },
  "evidence": [{
    "accepting_new_patients": true,
    "source": { "type": "plan_directory", "as_of": "2026-10-29" }
  }],
  "request_id": "req_7f3a2c"
}
The check call

Two fields decide the booking screen.

answer"listed" or "not_found". Drives the message you show.
accepting_new_patientsWhether the directory marks the clinician as open to new patients, for first visits.
source.as_ofThe date to show beside the answer and to keep with the appointment.

Words for each answer, ready to use.

Suggested patient-facing lines. Each one says only what the answer supports.

WHEN THE ANSWER IS LISTED

“Your plan's directory lists this clinician. Checked 29 October 2026.”

WHEN THE ANSWER IS NOT FOUND

“We could not find this clinician in your plan's current directory. Please confirm with your plan before your visit.”

What your team gets.

PATIENTSBook with a clinician their plan lists, and see the date of that answer.
COORDINATORSWork from a list already narrowed to the patient's plan.
OPERATIONSA request ID and read date on every appointment, for audits and follow-up.

Add the check to your next booking.

Single checks work on every plan, including Free. Narrowing a clinician list by plan uses plan-to-provider search, part of Growth at $599 a month with 150,000 calls and priority support.