Fill a prior authorization fax form. Provide the patient’s plan identifiers (bin, pcn, group, member_id, state) along with patient, prescriber, drug, and clinical-question data; the backend resolves the correct PA form and fills it. Returns a form ID and a signed URL to preview the filled PDF. Call Submit Prior Authorization with the ID to transmit the fax to the payer.
Simplex API Key
Patient demographics written to the fax form. Supplied as a JSON string in the patient multipart field. Supply either name (full name) or the split components (first_name + last_name, plus optional prefix/middle_name/suffix). When both are provided, the split components take precedence — payer forms with separate name fields (Caremark, Express Scripts, OptumRx) map each component directly.
Prescriber information written to the fax form. Supplied as a JSON string in the prescriber multipart field. Supply either name (full name) or the split components (first_name + last_name). When both are provided, the split components take precedence.
Requested drug details written to the fax form. Supplied as a JSON string in the drug_info multipart field.
Pharmacy BIN (Bank Identification Number) from the patient's insurance card (e.g. "003858"). Optional, but strongly improves form-resolver accuracy.
Processor Control Number from the patient's insurance card (e.g. "A4"). Optional, but tiebreaks plans that share a BIN.
NCPDP Group ID / group number from the patient's insurance card (e.g. "RXINN01"). Used as a tiebreaker when (BIN, PCN) hits multiple lines of business.
Full member ID from the patient's insurance card (e.g. "4XS00000523646"). Optional. The resolver uses the leading alpha prefix to tiebreak shared-processor BINs where one (BIN, PCN) pair spans multiple lines of business (e.g. BIN 003858 / PCN A4 hosts ESI Commercial and Humana Part D). PHI: do not log the full value downstream.
Two-letter state code where the prescription will be filled (e.g. "CA"). Required for state-mandated form variants and for Medicaid FFS routing.
Drug brand or generic name (e.g. "wegovy", "semaglutide"). Optional — refines benefit classification (pharmacy vs medical) and form ranking.
11-digit NDC. Optional — used for CMS Part B pharmacy/medical crosswalk.
Answers to the form's clinical questions. Use Get Clinical Questions to retrieve the question_id values for the patient's diagnosis and plan; the answer format must match the question's expected type (boolean → "Yes"/"No", free text → string, etc.).
Optional supporting documents (chart notes, lab results, imaging) to append to the fax.
Whether the form was filled successfully.
UUID of the filled form. Pass this to Submit Prior Authorization to transmit and to Check Status to track.
Time-limited signed URL to preview the filled PDF. Use this to review the form before submitting.
When the signed URL expires.