Skip to main content
Refill risk answers a specific question: when this prescription next comes up for a fill, will the prescriber still be licensed in the state that matters? Blend predicts the next fill date from the last fill and the days supply, then checks the prescriber’s state licenses against it. Add refill_risk=true to any prescriptions request and each prescription comes back with a nested refill_risk object. It’s a forward-looking check, not a status. A prescription can be perfectly valid today and still be at risk, because the license covering it expires before the patient is due for their next fill.

​
Ask for the assessment

The same parameter works on a single prescription and on a patient’s prescriptions:
The refill_risk object is omitted entirely unless you pass the parameter. Don’t write code that expects it on every prescription response.

​
Reading the result

at_risk is the field to alert on. It’s true when the covering license is missing today, or expires before the predicted next fill. When at_risk is true, reasons tells you which: The assessment also returns predicted_next_fill_date, last_fill_date, days_supply_used, relevant_states, covering_licenses, earliest_covering_expiration, days_until_next_fill, and days_until_license_expiry — enough to build a prioritized worklist rather than a flat alert.

​
When it doesn’t apply

applicable: false means Blend skipped the assessment, and not_applicable_reason says why:
  • cancelled — the prescription is cancelled
  • rx_expired — the prescription has already expired
  • no_fills_remaining — nothing left to fill
  • no_prescriber — no prescriber attached
  • no_relevant_states — no state could be determined to check against
These are not problems to fix. A cancelled prescription has no next fill to be at risk for.
Run this weekly across your active prescriptions and sort by days_until_next_fill. A license expiring in 90 days matters far less than one expiring before a fill that’s due next week.
Refill risk is a licensing check, not a clinical or timing one. It won’t tell you whether a refill is too early to fill, or whether the prescription itself is close to expiring — check expires_at and fills_remaining on the prescription for those.

​
Fixing what it finds

The remedy is almost always to update the prescriber’s state license. Add or renew one with POST /prescribers/{prescriber_id}/qualifications, or manage licenses directly in the Blend Dashboard under Prescribers. Blend also monitors prescriber credentials on your behalf — see does Blend track prescriber license status for me?

Get prescriptions

refill_risk=true

Get a prescription

refill_risk=true

Create a license/qualification

Add a state license

Get a prescriber's details

Current licenses and credentials