Guide: benefits and ICHRA
For each plan on offer, show which of an employee's doctors the plan's directory lists. One batch call answers up to 100 doctor-plan pairs.
Build the pairs
Collect the NPIs of the doctors each employee wants to keep, and the plan ids on offer for that employee. Every doctor-plan combination is one pair. Three doctors and eight plans make 24 pairs: one batch call, 24 calls against your quota.
Need the NPI of a doctor your user names? Store the NPI when the user picks the doctor in your own search, then send it here.
Check them in one call
curl https://api.inplan.io/v1/check/batch \ -H "Authorization: Bearer $INPLAN_KEY" \ -H "Content-Type: application/json" \ -d '{"year":2026,"items":[{"npi":"1184617268","plan_id":"29276OH0970001"},{"npi":"1184617268","plan_id":"29276OH0970002"}]}'
Group the results by plan_id. A plan that lists every doctor keeps the employee's care team; show it first.
Show the answer
- For
listed, show "Listed" with the plan year and the date fromevidence[].source.as_of. - For
not_found, show "Not found" and ask the employee to confirm with the plan. Never show "out of network". - Put the note from
notesnear the results: directories change, so confirm before care.
Plan for volume
Each pair is one call. An open-enrollment week can be your busiest month, so size your plan on that month. X-Quota-Remaining on every response tells you how many calls are left. Batch checks need Builder or above. See Batch checks.