Choose a processing mode
Setpreferred_processing_mode when creating a benefit verification. The field
defaults to standard.
How real-time processing works
The API is asynchronous: creation returns a benefit verification ID. Read the result withGET /benefit-verification/{id}
or receive it through a webhook.
A successful real-time result uses the same response fields and completeness
requirements as a successful standard result. Lower real-time coverage means
that fewer requests qualify for or complete through the fast path, not that
successful results contain fewer fields.
Track the current processing mode
The responses fromPOST /benefit-verification
and GET /benefit-verification/{id}
include data.current_processing_mode:
current_processing_mode as follows:
realtimemeans the request is assigned to real-time processing or completed through it.standardmeans the full standard benefit verification process owns the request. A request withpreferred_processing_mode: "realtime"can returnstandardimmediately or change fromrealtimetostandardafter fallback.
completed or failed. Check GET /benefit-verification/{id} for a cancelled
status or a processing-mode change before completion or failure.
Fallback behavior
Arealtime request continues in standard processing on the same benefit
verification when:
- real-time processing is unavailable for the request;
- real-time verification cannot return a complete result; or
- the 30-second deadline is reached before every requested drug completes.
current_processing_mode: "standard", and standard processing begins
immediately.
Fallback can also happen after a real-time attempt starts. Subsequent responses
from GET /benefit-verification/{id} show current_processing_mode: "standard".
Continue tracking the same benefit verification ID for the final status and result.
A realtime_only request never falls back. If real-time verification is
unavailable or cannot complete within 30 seconds, the benefit verification fails.
Input requirements
Requests for either real-time mode must include an NDC for every requested drug. If any drug omits its NDC, the API rejects the request without creating a benefit verification. The real-time path also requires structured insurance data ininsurance_content, including the member number and the Rx BIN, Rx PCN, and Rx
group when applicable. Insurance-card images or patient demographics alone do
not qualify a request for real-time processing.
Limitations
- Every requested drug must complete before the 30-second timeout. Partial multi-drug results do not count as real-time completion.
- Coverage varies by patient, plan, pharmacy benefit manager (PBM), drug, and organization configuration.
- Real-time processing has lower rate limits than standard processing. Available
capacity can vary, so
realtimerequests may fall back andrealtime_onlyrequests may fail during traffic bursts.