BestRx APIs
Contact Us
  1. Patient API
  • Introduction - BestRx APIs
  • Patient API
    • Overview
    • Error Codes
    • Add Patient
      POST
    • Update Patient
      POST
    • Get Patient
      POST
    • Submit Charge Account Payment
      POST
  • Drug API
    • Overview
    • Error Codes
    • Get Drug Information
      POST
  • Prescription API
    • Overview
    • Error Codes
    • Submit Rx Transfer Request
      POST
    • Return to Stock
      POST
    • Save Rx Signature
      POST
  • Refill API
    • Overview
    • Error Codes
    • GetPatientProfile
      POST
    • Send Refill Request
      POST
  • BestPOS API
    • Overview
    • Error Codes
    • Create POS Transaction
      POST
    • Get POS Transaction Status
      POST
    • Get Item Details
      POST
  • Delivery/Shipping Provider API
    • Overview
    • Error Codes
    • Address Validation
    • Create Order
    • Update Order Status
    • Cancel Order
  • Realtime Data Feed Specification
    • Overview
    • Patient Update Callback
    • E-Prescription Notification Callback
    • Prescription Update Callback
  1. Patient API

Update Patient

POST
https://dataservice.bestrxconnect.com/patient/updatepatient
INFO
This endpoint is used to update an existing patient in the BestRx System.

Request

Body Params application/json

Example
{
    "unique_patient_id": 123456,
    "allow_duplicate": false,
    "relates_to_patient_id": 12345,
    "last_name": "Kennedy",
    "middle_name": "Fitzgerald",
    "first_name": "John",
    "name_prefix": "Mr",
    "name_suffix": "Jr",
    "dob": "1917-05-29",
    "gender": "M",
    "address1": "1234, First Street",
    "address2": "Apt 107",
    "city": "OAK BROOK",
    "state": "IL",
    "county": "Cook",
    "zipcode": "60523",
    "country_code": "USA",
    "home_phone": "9876543210",
    "work_phone": "9876543210",
    "cell_phone": "9876543210",
    "fax_number": "9876543210",
    "family_email": "family@email.com",
    "patient_email": "patient@email.com",
    "marital_status": "S",
    "bill_last_name": "Kennedy",
    "bill_first_name": "John",
    "bill_address_careof": "John F. Kennedy",
    "bill_address1": "3423, FIRST STREET",
    "bill_address2": "Apt 107",
    "bill_address_city": "OAK BROOK",
    "bill_address_state": "IL",
    "bill_address_zipcode": "605231234",
    "bill_phone": "9876543210",
    "patient_id_qualifier": "01",
    "patient_id": "P123-4567-8900",
    "social_security_number": "123456789",
    "smoker": true,
    "loyalty_number": "123456",
    "residence_code": "01",
    "dispense_by": "P",
    "340B_patient": true,
    "is_pet": false,
    "pet_name": "",
    "is_active": true,
    "is_deceased": false,
    "language": "English",
    "patient_race": "Indigenous",
    "patient_ethnicity": "Hispanic",
    "PharmacyNumber": "1234567890",
    "PharmacyNCPDP": "1234567",
    "Allergies": [
        {
            "alg_qualifier": "MSKDC",
            "alg_code": "00032",
            "alg_description": "Aloprim"
        }
    ],
    "insurance_plans": [
        {
            "ins_bin": "610084",
            "ins_pcn": "DRTXPROD",
            "ins_code": "BCBSIL",
            "ins_name": "Blue Cross Blue Shield of Illinois",
            "ins_address1": "1234 SOME STREET",
            "ins_address2": "Suite 3",
            "ins_city": "Chicago",
            "ins_state": "IL",
            "ins_zipcode": "605231234",
            "ins_phone": "1234567890",
            "ins_remark": "Insurance Test Remark",
            "ins_fax_number": "1234567890",
            "ins_alternate_phone": "1234567890",
            "ins_email": "insurance@email.com",
            "ins_insurancegroupname": "Test Group Name",
            "ins_seq_no": 1,
            "ins_cardholder_id": "1234567890",
            "ins_person_code": "01",
            "ins_relation_code": "1",
            "ins_group": "DRS879",
            "ins_is_primary": true
        }
    ],
    "PatientAddresses": [
        {
            "AddressID": 123,
            "AddressType": 1,
            "Address": "123 Powlowski Lane",
            "Address2": "Apt. 123",
            "City": "North Forest",
            "State": "FL",
            "Zip": "12345",
            "IsDefaultShippingAddress": false
        },
        {
            "AddressID": 124,
            "AddressType": 2,
            "Address": "567 State Line Road",
            "Address2": "Ste 123",
            "City": "North Imogenechester",
            "State": "DC",
            "Zip": "56789",
            "IsDefaultShippingAddress": true
        }
    ]
}

Responses

🟢200OK
application/json
Body

Example
{
    "Data": {
        "insurance_plans": [
            {
                "ins_bin": "610084",
                "ins_pcn": "DRTXPROD",
                "ins_code": "BCBSIL",
                "ins_name": "BLUE CROSS BLUE SHIELD OF ILLINOIS",
                "ins_address1": "1234 SOME STREET",
                "ins_address2": "SUITE 3",
                "ins_city": "CHICAGO",
                "ins_state": "IL",
                "ins_zipcode": "605231234",
                "ins_phone": "1234567890",
                "ins_remark": "Insurance Test Remark",
                "ins_fax_number": "1234567890",
                "ins_alternate_phone": "1234567890",
                "ins_email": "insurance@email.com",
                "ins_seq_no": 1,
                "ins_cardholder_id": "1234567890",
                "ins_person_code": "01",
                "ins_relation_code": "1",
                "ins_group": "DRS879",
                "ins_is_primary": true,
                "IsValid": true,
                "Messages": []
            }
        ],
        "PatientAddresses": [
            {
                "AddressID": 123,
                "AddressType": 1,
                "Address": "123 Powlowski Lane",
                "Address2": "Apt. 123",
                "City": "North Forest",
                "State": "FL",
                "Zip": "12345",
                "IsDefaultShippingAddress": false
            },
            {
                "AddressID": 124,
                "AddressType": 2,
                "Address": "567 State Line Road",
                "Address2": "Ste 123",
                "City": "North Imogenechester",
                "State": "DC",
                "Zip": "56789",
                "IsDefaultShippingAddress": true
            }
        ],
        "unique_patient_id": 123456,
        "allow_duplicate": false,
        "relates_to_patient_id": 12345,
        "last_name": "KENNEDY",
        "middle_name": "FITZGERALD",
        "first_name": "JOHN",
        "name_prefix": "MR",
        "name_suffix": "JR",
        "dob": "1917-05-29T00:00:00",
        "gender": 1,
        "address1": "1234, FIRST STREET",
        "address2": "APT 107",
        "city": "OAK BROOK",
        "state": "IL",
        "county": null,
        "zipcode": "60523",
        "country_code": "US",
        "home_phone": "9876543210",
        "work_phone": "9876543210",
        "cell_phone": "9876543210",
        "fax_number": "9876543210",
        "family_email": "family@email.com",
        "patient_email": "patient@email.com",
        "marital_status": "S",
        "bill_last_name": "KENNEDY",
        "bill_first_name": "JOHN",
        "bill_address_careof": "JOHN F. KENNEDY",
        "bill_address1": "3423, FIRST STREET",
        "bill_address2": "APT 107",
        "bill_address_city": "OAK BROOK",
        "bill_address_state": "IL",
        "bill_address_zipcode": "605231234",
        "bill_phone": "9876543210",
        "patient_id_qualifier": "01",
        "patient_id": "P123-4567-8900",
        "social_security_number": "123456789",
        "smoker": true,
        "loyalty_number": "123456",
        "residence_code": "01",
        "dispense_by": "P",
        "340B_patient": true,
        "is_pet": false,
        "pet_name": "",
        "patient_short_remark": "Test Short Remark",
        "patient_remark": "Patient Remark",
        "family_remark": "Family Remark",
        "is_active": true,
        "is_deceased": false,
        "language": 0,
        "patient_race": 0,
        "patient_ethnicity": 0,
        "allergies": [
            {
                "alg_qualifier": "MSKDC",
                "alg_code": "00032",
                "alg_description": "Aloprim"
            }
        ],
        "PharmacyNumber": "1234567890",
        "PharmacyNCPDP": "1234567"
    },
    "IsValid": true,
    "Messages": []
}
🟠400Bad Request
Modified at 2025-07-16 15:57:49
Previous
Add Patient
Next
Get Patient