Insurances

Create

Note

Please note that the price may change between the patient checks the cost with insurance and schedules a consultation. This is caused by the possibility that the deductibles and out-of-pocket values might change between the time.

To add or update an insurance payer to a patient, make a request to:

HTTP Request

POST {server_url}/api/v1/patients/{patient_id}/insurances

This request must include a valid User JWT token, please see our documentation.

Header Parameter

Parameter	Default
Content-type	application/json
Accept	application/json
Authorization	Bearer {jwttoken}

URL Parameter

Parameter	Required	Description
patient_id	true	MD Live ID for patient

Request Body Parameters

Parameter	Type	Required	Description
insurance	object	true	Object containing insurance information
↳  insurance_detail	object	true	Object containing patient’s insurance details
↳↳  insurance_payer_id	integer	true	MD Live ID of the insurance payer
↳↳  member_id	string	true	Patient’s Insurance Member ID
↳↳  is_dependent	boolean	true	Patient’s coverage type
↳  primary_insurance_details	object	false (true if dependent)	Object containing primary insurance details
↳↳  first_name	string	false (true if dependent)	Primary member’s first name
↳↳  last_name	string	false (true if dependent)	Primary member’s last name
↳↳  gender	string	false (true if dependent)	Primary member’s gender
↳↳  dob	string	false (true if dependent)	Primary member’s birthdate
↳↳  member_id	string	false (true if dependent)	Primary member’s Insurance Member ID

Example Request

Shell

curl -X POST {server_url}/api/v1/patients/{patient_id}/insurances
-H "Content-type: application/json"
-H "Authorization: Bearer {jwt_token}"
-H "Accept: application/json"
-d '{
      "insurance": {
        "insurance_details": {
          "insurance_payer_id": 27,
          "member_id": "MDL684088116",
          "is_dependent": false
        },
        "primary_insurance_details": {
          "relationship": "",
          "first_name":  "",
          "last_name": "",
          "gender": "",
          "dob": "",
          "member_id": ""
        }
      }
    }'

Ruby

RestClient::Request.new(
  :method => :post,
  :url => "{server_url}/api/v1/patients/{patient_id}/insurances",
  :headers => {
    "Content-type" => "application/json",
    "Authorization" => "Bearer {jwt_token}",
    "Accept" => "application/json"
  },
  :payload => {
    "insurance" => {
      "insurance_details" => {
        "insurance_payer_id" => 27,
        "member_id" => "MDL684088116",
        "is_dependent" => false
      },
      "primary_insurance_details": {
        "relationship" => "",
        "first_name" => "",
        "last_name" => "",
        "gender" => "",
        "dob" => "",
        "member_id" => ""
      }
    }
  }
).execute

Example Response

When the patient is eligible for telemedicine visits, the above command returns JSON structured like this:

{
    "insurance": {
        "eligibility_errors": [],
        "eligible": true,
        "id": 2,
        "insurance_payer_id": 27,
        "is_dependent": false,
        "member_id": "MDL684088116",
        "primary_insurance": null
    }
}

When the patient is ineligible for telemedicine visits, the above command returns JSON structured like this:

{
    "insurance": {
        "eligibility_errors": [
            {
                "code": "incorrect_subscriber_id",
                "message": "Invalid/Missing Subscriber/Insured ID"
            }
        ],
        "eligible": false,
        "id": 2,
        "insurance_payer_id": 27,
        "is_dependent": false,
        "member_id": "MDL684088116",
        "primary_insurance": null
    }
}