Create New Rx From eFax

INFO

This endpoint is used to create a prescription for electronic fax and attach a fax image.

Additional contracts and transaction fees will apply to use this API. Please contact BestRx for an additional information.

Request

Body Params application/jsonRequired

Example

{
    "pharmacy_number": "1234567890",
    "fax_provider": 1,
    "fax_provider_fax_id": "12345PROVIDERFAXID",
    "bestrx_fax_id": 1234,
    "action_for_fax_after_rx_creation": 0,
    "pages_to_link": [
        {
            "page_no": 1
        },
        {
            "page_no": 2
        }
    ],
    "user_id": "Smith",
    "date_of_service": "2025-12-31",
    "written_date": "2025-10-31",
    "effective_date": "2025-11-01",
    "rph_initials": "XYZ",
    "tech_initials": "ABC",
    "place_rx_on_hold": false,
    "rx_queue_recno": 1,
    "product_id_to_dispense": "12345678901",
    "product_quickcode_to_dispense": "SIMV10MG",
    "qty_prescribed": 10,
    "qty_to_dispense": 10,
    "days_supply_to_dispense": 10,
    "refills_authorized": 2,
    "sig_directions": "TAKE 1 TABLET A DAY",
    "daw_code": "0",
    "rx_serial_number": "",
    "rx_note": "This prescription is created via eFax API.",
    "unique_patient_id": 123,
    "patient": {
        "last_name": "Blanco",
        "first_name": "Michele",
        "middle_name": "Anne",
        "name_prefix": "Mrs",
        "name_suffix": "Jr",
        "date_of_birth": "1990-12-31",
        "gender": 2,
        "primary_address": {
            "street_address_line1": "1234 First Street",
            "street_address_line2": "Apt 107",
            "city": "Oak Brook",
            "state_or_province": "IL",
            "postal_code": "60523"
        },
        "additional_addresses": [
            {
                "AddressType": 1,
                "Address": "1234 Powlowski Lane",
                "Address2": "Apt 123",
                "City": "Bartlett",
                "State": "IL",
                "Zip": "60103",
                "IsDefaultShippingAddress": true
            },
            {
                "AddressType": 2,
                "Address": "5678 State Line Road",
                "Address2": "Ste 123",
                "City": "Chicago",
                "State": "IL",
                "Zip": "60007",
                "IsDefaultShippingAddress": false
            }
        ],
        "cell_phone": "9876543210",
        "home_phone": "1234567890",
        "work_phone": "9988776655",
        "family_email": "family@email.com",
        "patient_email": "patient@email.com",
        "marital_status": "S",
        "social_security_number": "123456789",
        "dispense_by": "P",
        "patient_340B": false,
        "patient_short_remark": "Patient Short Remark",
        "patient_remark": "Patient Long Remark",
        "family_remark": "Patient Family Remark",
        "language": "0",
        "insurance_plans": [
            {
                "ins_code": "BCBS",
                "ins_name": "Blue Cross Blue Shield",
                "ins_bin": "123456",
                "ins_pcn": "ABCDEFG",
                "ins_group": "MCD_INS_GROUP",
                "ins_person_code": "01",
                "ins_relation_code": "1",
                "ins_cardholder_id": "123456789",
                "ins_cardholder_lastname": "Blanco",
                "ins_cardholder_firstname": "Michele",
                "ins_is_primary_for_patient": true
            }
        ],
        "patient_allergies": [
            {
                "alg_qualifier": "MSKDC",
                "alg_code": "00982",
                "alg_description": "Penicillin G"
            },
            {
                "alg_qualifier": "MSKDC",
                "alg_code": "00753",
                "alg_description": "Milk of Magnesia"
            }
        ]
    },
    "unique_prescriber_id": 12345,
    "prescriber": {
        "last_name": "Doe",
        "first_name": "Jane",
        "npi_number": "1234567890",
        "dea_number": "AB1234567",
        "state_license_number": "1234567",
        "office_phone": "7732229987",
        "office_phone_ext": "123",
        "fax_phone": "7732229999",
        "email_address": "doejane@email.com",
        "address": {
            "street_address_line1": "1234 Medical Center",
            "street_address_line2": "Ste C",
            "city": "Chicago",
            "state_or_province": "IL",
            "postal_code": "60612"
        }
    },
    "rx_diagnosis": [
        {
            "DiagnosisCode": "I10"
        },
        {
            "DiagnosisCode": "E78.00"
        }
    ],
    "pharmacy_to_link": {
        "pharmacy_name": "BestRx Pharmacy",
        "address": {
            "street_address_line1": "2625 Butterfield Road",
            "street_address_line2": "Suite 200S",
            "city": "Oak Brook",
            "state_or_province": "IL",
            "postal_code": "60523"
        },
        "main_phone": "9876543210",
        "fax_phone": "9876543210",
        "pharmacy_npi": "9876543210",
        "pharmacy_ncpdp": "1234567",
        "pharmacy_dea": "AB1234567",
        "pharmacist_last_name": "John",
        "pharmacist_first_name": "Smith"
    },
    "transfer_from_pharmacy": {
        "PharmacyRecno": 1,
        "PharmacyName": "Oak Brook Pharmacy",
        "Address": {
            "StreetAddress1": "1200 Jorie Blvd",
            "StreetAddress2": "Suite 310",
            "City": "Oak Brook",
            "State": "IL",
            "ZipCode": "60523"
        },
        "MainPhone": "1234567890",
        "FaxPhone": "1234567890",
        "NPI": "1234567890",
        "NCPDP": "7654321",
        "DEA": "XY1234567",
        "PharmacistLastName": "Steve",
        "PharmacistFirstName": "Matthew"
    },
    "transfer_rx_info": {
        "TransferDate": "2025/12/30",
        "OriginalRxNumber": 123456,
        "OriginalFillDate": "2025/11/01",
        "MostRecentFillDate": "2025/12/01",
        "OriginalRefillsAuth": 3,
        "FillsRemaining": 2,
        "TotalQtyDispensedToDate": 20,
        "TotalQtyRemaining": 20
    }
}

Responses

🟢200Success

application/json

Body

Example

{
    "Data": {
        "CreateRxStatus": 0,
        "CreateRxStatusDesc": "Prescription Record Successfully Created",
        "CreatedRxInfo": {
            "APIKey": "",
            "PharmacyNumber": "1234567890",
            "PharmacyNumber_Alt": "",
            "pharmacy_info": {
                "pharmacy_name": "BestRx QA Pharmacy",
                "address": {
                    "address1": "2625 Butterfield Rd",
                    "address2": "200S",
                    "city": "OakBrook",
                    "state": "IL",
                    "zipcode": "60523"
                },
                "phone_number": "6308939210",
                "fax_number": "6303393171",
                "npi": "1234567890",
                "ncpdp": "7878785",
                "dea": "XY1234567"
            },
            "transaction_id": "123456",
            "transaction_date": "2025-10-31",
            "transaction_time": "23:59:59",
            "transaction_time_fraction": "3591840",
            "rx_number": "123456",
            "patient_id": 123,
            "patient_last_name": "BLANCO",
            "patient_first_name": "MICHELE",
            "patient_middle_name": "ANNE",
            "patient_prefix": "MRS",
            "patient_suffix": "JR",
            "patient_address1": "1234 FIRST STREET",
            "patient_address2": "APT 107",
            "patient_city": "OAK BROOK",
            "patient_state": "IL",
            "patient_zip": "60523",
            "patient_home_phone": "1234567890",
            "patient_cell_phone": "9876543210",
            "patient_work_phone": "9988776655",
            "patient_dob": "1990-12-31",
            "patient_gender": "F",
            "patient_email": "patient@email.com",
            "patient_group": [
                {
                    "group_code": "1",
                    "group_name": "ABC"
                }
            ],
            "family_email": "family@email.com",
            "patient_short_remark": "Patient Short Remark",
            "patient_remark": "Patient Long Remark",
            "family_remark": "Patient Family Remark",
            "patient_shipto_organization": "BLANCO ORGANIZATION",
            "patient_shipto_last_name": "BLANCO",
            "patient_shipto_first_name": "MICHELE",
            "patient_shipto_careof": "VALARIE BLANCO",
            "patient_shipto_address1": "1234 FIRST STREET",
            "patient_shipto_address2": "APT 107",
            "patient_shipto_city": "OAK BROOK",
            "patient_shipto_state": "IL",
            "patient_shipto_zip": "60523",
            "patient_shipto_phone": "1234567890",
            "is_ltc_patient": true,
            "ltc_facility": {
                "ltc_facility_internal_id": 123,
                "ltc_facility_name": "JOSEPH REHABILITATION CENTER",
                "ltc_facility_code": "JRC",
                "ltc_facility_payer_id": "12345",
                "ltc_facility_contact_name": "Jos",
                "ltc_facility_address": {
                    "address1": "1234 Newport Dr",
                    "address2": "S111",
                    "city": "Wheaton",
                    "state": "IL",
                    "zipcode": "60187"
                },
                "ltc_facility_phone": "6301234567",
                "ltc_facility_fax": "6307654321",
                "ltc_facility_alt_phone1": "9876543210",
                "ltc_facility_alt_phone2": "1234567890"
            },
            "is_deactivated": false,
            "transferred_out": false,
            "transferred_pharmacy": "",
            "transferred_pharmacy_address1": "",
            "transferred_pharmacy_address2": "",
            "transferred_pharmacy_city": "",
            "transferred_pharmacy_state": "",
            "transferred_pharmacy_zip": "",
            "transferred_pharmacy_phone": "",
            "transferred_pharmacy_fax": "",
            "transferred_pharmacy_ncpdp": "",
            "transferred_pharmacy_npi": "",
            "transferred_pharmacy_dea": "",
            "transfer_date": "",
            "transfer_contact_name": "",
            "transfer_rph_initials": "",
            "transfer_rph_user_id": "",
            "transfer_rph_last_name": "",
            "transfer_rph_first_name": "",
            "transferfrom_pharmacy": {
                "pharmacy_name": "Oak Brook Pharmacy",
                "address": {
                    "address1": "1200 Jorie Blvd",
                    "address2": "Suite 310",
                    "city": "Oak Brook",
                    "state": "IL",
                    "zipcode": "60523"
                },
                "phone_number": "1234567890",
                "fax_number": "1234567890",
                "npi": "1122334455",
                "ncpdp": "7654321",
                "dea": "XY1234567"
            },
            "bill_status": "1",
            "bill_status_text": "Unbilled",
            "workflow_status": "0",
            "workflow_status_text": "Entered into System",
            "workflow_step_performed_code": "1",
            "workflow_step_performed_text": "Entered into System",
            "workflow_step_performed_userid": "BestRx API",
            "workflow_queues": [
                {
                    "queue_code": 1,
                    "queue_name": "New Rxs"
                }
            ],
            "fill_number": "1",
            "fill_date": "2025-12-31",
            "fill_time": "23:59:59",
            "picked_up": "false",
            "delivered": "false",
            "qty_ordered": "10",
            "qty_filled": "10",
            "days_supply": "10",
            "refills_authorized": "2",
            "refills_remaining": "2",
            "refill_number": "0",
            "refill_exp_date": "2026-10-30",
            "item_upc_code": "",
            "drug_ndc": "12345678901",
            "drug_ndc_10digit": "1234567890",
            "drug_ndc_10digit_formatted": "123-456-7890",
            "drug_gpi": "12300010100210",
            "drug_name": "SIMVASTATIN 10 MG",
            "drug_strength": "MG",
            "drug_mfg": "PFIZER",
            "drug_schedule": "0",
            "drug_is_generic": "true",
            "drug_brand_name": "ZOCOR",
            "drug_package_size": "3",
            "drug_form": "EACH",
            "drug_color": "WHITE",
            "drug_shape": "ROUND",
            "drug_front_imprint": "S",
            "drug_back_imprint": "01",
            "drug_misc_info": "WHITE TO OFF-WHITE",
            "lot_number": "LOT1234",
            "lot_exp_date": "2050-12-31",
            "retail": "11.99",
            "billed": "11.99",
            "payers": [
                {
                    "plan_seq_no": "1",
                    "plan_code": "BCBS",
                    "plan_name": "Blue Cross Blue Shield",
                    "plan_bin": "123456",
                    "plan_pcn": "ABCDEFG",
                    "card_id": "123456789",
                    "group": "MCD_INS_GROUP",
                    "person_code": "01",
                    "relation_code": "1",
                    "plan_bill_status": "1",
                    "plan_bill_status_text": "Unbilled",
                    "cost_paid": "0.00",
                    "disp_fee_paid": "0.00",
                    "tax_paid": "0.00",
                    "discount": "0.00",
                    "pat_pay_amount": "0.00",
                    "due_from_payer": "0.00",
                    "applied_to_deductible": null,
                    "accumulated_deductible": null,
                    "remaining_deductible": null
                }
            ],
            "cost": "5.67",
            "patient_amount_due": "0.00",
            "due_from_insurance": "0.00",
            "total_paid": "0.00",
            "margin": "-5.67",
            "margin_percent": "-100.00",
            "is340b": "false",
            "dispense_as_written": "false",
            "daw_code": "0",
            "date_rx_written": "2025-10-31",
            "signature": "TAKE 1 TABLET A DAY",
            "dosage_info": [
                {
                    "dose_slot": 1,
                    "dose_time": "MORNING",
                    "dose_qty": "1",
                    "dose_days": "daily"
                }
            ],
            "rx_source": "4 - Fax",
            "rph_initials": "XYZ",
            "tech_initials": "ABC",
            "rx_serial_number": "",
            "submission_clar_code": "",
            "other_coverage_code": "",
            "horizon_graveyard_code": "",
            "diagnosis": [
                {
                    "qualifier": "02",
                    "code": "I10",
                    "description": "Essential (primary) hypertension"
                },
                {
                    "qualifier": "02",
                    "code": "E78.00",
                    "description": "Pure hypercholesterolemia, unspecified"
                }
            ],
            "doctor_id": 12345,
            "doctor_last_name": "DOE",
            "doctor_first_name": "JANE",
            "doctor_middle_name": "A",
            "doctor_prefix": "DR.",
            "doctor_suffix": "JR.",
            "doctor_npi": "1234567890",
            "doctor_dea": "AB1234567",
            "doctor_state_licno": "1234567",
            "doctor_dps_no": "",
            "doctor_medicaid_no": "1234567890",
            "doctor_upin": "A1B2C3D",
            "doctor_address1": "West City Medical Center",
            "doctor_address2": "STE C",
            "doctor_city": "CHICAGO",
            "doctor_state": "IL",
            "doctor_zip": "60612",
            "doctor_phone": "7732229987",
            "doctor_fax": "7732229999",
            "doctor_email": "doejane@email.com",
            "doctor_remark": "CALL OFFICE NUMBER FIRST",
            "doctor_profession_code": "",
            "doctor_profession_desc": "",
            "doctor_ama_specialty_code": "",
            "doctor_ama_grouping": "",
            "doctor_ama_classification": "",
            "doctor_ama_specialization": "",
            "doctor_surescripts_service_level": "New, Refill, Change, RxFill, Cancel, ePA",
            "next_refill_date": "2026-01-31",
            "drug_therapeutic_class": "",
            "prescribed_drug": "SIMVASTATIN 10 MG",
            "filled_by": "",
            "erx_message_id": "",
            "erx_prescriber_order_no": "",
            "erx_patient_medical_record_no": "",
            "erx_facility_code": "",
            "rx_remark": "This prescription is created via eFax API.",
            "erx_pharmacy_remark": "",
            "erx_prescriber_remark": "",
            "erx_drug_notes": "",
            "written_date_remark": "",
            "inactivate_rx_remark": "",
            "shipping_provider": "",
            "shipping_tracking_number": "",
            "dispense_using": "Safety Caps",
            "is_medsync_shortfill": false,
            "claim_reject_info": [],
            "pbm_message": null,
            "claim_additional_messages": [],
            "document_count": 1,
            "lot_serial_info": [
                {
                    "drug_ndc": "1234567890",
                    "qty": 10.0,
                    "compound_seqno": 0,
                    "lot_number": "12345",
                    "lot_exp_date": "2025-12-31",
                    "serial_number": "1234567890"
                }
            ],
            "ProgramInfo": {
                "ApplicationName": "Internet Information Services",
                "ApplicationVersion": "10.0.17763.1",
                "ComputerName": "BESTRX_VMSERVER",
                "ComputerUser": "IIS APPPOOL\\CREATERXFROMEFAXAPI"
            }
        }
    },
    "IsValid": true,
    "Messages": []
}

🟢200Information does not match

🟠400Missing Pharmacy Number