Table of Contents |
---|
Retrieve data list
GET api_v3/insurances/list/insurers
GET api_v3/insurances/list/billing_modifiers
GET api_v3/insurances/list/dxs
GET api_v3/insurances/list/procedures
Create / update delete / retrieve insurance detail
Sample insurance schema:
Code Block | ||
---|---|---|
| ||
"insurance": [
{
"name": "Insurance",
"code": "insurance",
"card_type": "primary",
"next": {
"title": "Next"
},
"sections": [
{
"code": "insurance",
"default_value": [
"carrier_code",
"subscriber_num",
"group_number"
],
"prefill_mapping": {
"respparty": {
"self": {
"guarantor_name": "full_name",
"guarantor_dob": "dob",
"guarantor_address": "street_addr",
"guarantor_city": "city",
"guarantor_zip": "zip",
"guarantor_state": "state"
}
}
},
"schema": {
"has_ins": {
"type": "string",
"title": "",
"required": true,
"enum": [
"Yes",
"No"
],
"default": "No"
},
"carrier_code": {
"type": "string",
"title": "Primary Insurance Company Name",
"required": true,
"prefill": {
"user_attr": "insurance.primary.carrier_code"
},
"preload": {
"url": "https://api-vclinic.vsee.me/claims_v2/api_v3/insurances/list/insurers",
"format": {
"data": {
"id": "id",
"text": "text"
}
}
}
},
"carrier_name_others": {
"type": "string",
"title": "Other Insurance",
"required": true,
"prefill": {
"user_attr": "insurance.primary.carrier_name_others"
}
},
"subscriber_num": {
"type": "string",
"title": "Policy Number / Subscriber ID",
"required": true,
"prefill": {
"user_attr": "insurance.primary.subscriber_num"
}
},
"group_number": {
"type": "string",
"title": "Group Number",
"prefill": {
"user_attr": "insurance.patient.group_number"
}
},
"respparty": {
"type": "string",
"title": "Patient Relationship to Policy Holder",
"required": true,
"enum": [
"",
"self",
"child",
"spouse",
"other"
],
"prefill": {
"user_attr": "insurance.patient.respparty"
}
},
"guarantor_first_name": {
"type": "string",
"title": "Insured First Name",
"required": true,
"prefill": {
"user_attr": "first_name",
"only": "self"
}
},
"guarantor_last_name": {
"type": "string",
"title": "Insured Last Name",
"required": true,
"prefill": {
"user_attr": "last_name",
"only": "self"
}
},
"guarantor_middle_name": {
"type": "string",
"title": "Insured Middle Name",
"prefill": {
"user_attr": "extra.middle_name",
"only": "self"
},
"required": false
},
"guarantor_dob": {
"type": "string",
"title": "Insured Date of Birth",
"required": true,
"format": "yyyy-mm-dd",
"prefill": {
"user_attr": "dob",
"only": "self"
}
},
"guarantor_address": {
"type": "string",
"title": "Insured Address",
"required": true,
"prefill": {
"user_attr": "street_addr"
}
},
"guarantor_city": {
"type": "string",
"title": "Insured City",
"required": true,
"prefill": {
"user_attr": "city"
}
},
"guarantor_zip": {
"type": "string",
"title": "Insured Zip",
"required": true,
"prefill": {
"user_attr": "zip"
}
},
"guarantor_state": {
"type": "string",
"title": "Insured State",
"required": true,
"enum": [
"",
"AK",
"AL",
"AR",
"AZ",
"CA",
"CO",
"CT",
"DC",
"DE",
"FL",
"GA",
"HI",
"IA",
"ID",
"IL",
"IN",
"KS",
"KY",
"LA",
"MA",
"MD",
"ME",
"MI",
"MN",
"MO",
"MS",
"MT",
"NC",
"ND",
"NE",
"NH",
"NJ",
"NM",
"NV",
"NY",
"OH",
"OK",
"OR",
"PA",
"RI",
"SC",
"SD",
"TN",
"TX",
"UT",
"VA",
"VT",
"WA",
"WI",
"WV",
"WY"
],
"prefill": {
"user_attr": "state"
}
},
"card_front": {
"type": "string",
"title": "Upload Insurance Card (Front)",
"required": true,
"prefill": {
"user_attr": "insurance.primary.card_front"
}
},
"card_back": {
"type": "string",
"title": "Upload Insurance Card (Back)",
"required": true,
"prefill": {
"user_attr": "insurance.primary.card_back"
}
},
"consent": {
"type": "string",
"required": true,
"title": "I give the <a href='#'>authorization to bill insurance</a>"
}
},
"form": [
{
"type": "help",
"helpvalue": "We wish to offer clarity on how Company bills you/your insurance for services you received, please read the following before making a payment selection.<br /><br />Although we do accept your insurance information as a method to facilitate payment for the Company, We do not know (in real-time) details about your co-payment, deductible, or out-of-pocket expenses, which may affect insurance coverage and compensation for billed services. Our billed rates are based on coding rates set by our contract with your insurance. They range between $150-$350 (depending on codes and visit type). These rates, however, are not the same as our discounted cash visit rates. If you have insurance with high deductibles or out-of-pocket expenses, your insurance company may choose to apply the entire billed amount towards your deductible, and you will be responsible for the full billed amount in the future.<br /><br />For parents with high deductibles, out of pocket expenses or those who wish to avoid higher payments beyond the insurance billing option, we offer a discounted cash payment option. Our cash prices per visit are extremely competitive compared to current market rates of private providers or consultants, and they are discounted by 60% from our billable rates.<br /><br />Once we bill your insurance, we are unable to revert back to cash payment rates, and by law, we are required to collect the full amount applied toward your deductible or co-pay from you.<br /><br />"
},
{
"key": "has_ins",
"type": "radios",
"notitle": true,
"titleMap": {
"Yes": "I would like to use my insurance",
"No": "I would like to pay upfront for this visit (cash payment)"
},
"toggleMap": {
"Yes": {
"form": [
{
"type": "help",
"helpvalue": "<i style='color: red'>If you choose OTHER, you are required to upload the front and back pictures of your insurance card.</i>"
},
{
"key": "carrier_code",
"placeholder": "Type first 3 letters to search",
"type": "select2",
"titleMap": {
"car7551": "AETNA"
},
"htmlClass": "col-md-6 col-xs-6 col-sm-12",
"toggleMap": {
"OTHER": {
"form": [
{
"key": "carrier_name_others",
"placeholder": "Other Insurance",
"type": "text"
}
],
"htmlClass": "col-md-6 col-xs-6 col-sm-12"
}
}
},
{
"key": "subscriber_num",
"placeholder": "Enter Policy Number / Subscriber ID*",
"type": "text",
"htmlClass": "col-md-6 col-xs-6 col-sm-12"
},
{
"key": "group_number",
"placeholder": "Enter Group Number",
"type": "text",
"htmlClass": "col-md-6 col-xs-6 col-sm-12"
},
{
"key": "respparty",
"placeholder": "Select relationship",
"titleMap": {
"self": "Self",
"child": "Child",
"spouse": "Spouse",
"other": "Others"
},
"type": "select",
"htmlClass": "col-md-6 col-xs-6 col-sm-12"
},
{
"key": "guarantor_first_name",
"placeholder": "Enter Insured First Name*",
"type": "text",
"htmlClass": "col-md-6 col-xs-6 col-sm-12"
},
{
"key": "guarantor_last_name",
"placeholder": "Enter Insured Last Name*",
"type": "text",
"htmlClass": "col-md-6 col-xs-6 col-sm-12"
},
{
"key": "guarantor_middle_name",
"placeholder": "Enter Insured Middle Name",
"type": "text",
"htmlClass": "col-md-6 col-xs-6 col-sm-12"
},
{
"key": "guarantor_dob",
"type": "datepicker",
"htmlClass": "col-md-6 col-xs-6 col-sm-12"
},
{
"key": "guarantor_address",
"placeholder": "Enter address",
"type": "text",
"htmlClass": "col-md-6 col-xs-6 col-sm-12"
},
{
"key": "guarantor_city",
"placeholder": "Enter city",
"type": "text",
"htmlClass": "col-md-6 col-xs-6 col-sm-12"
},
{
"key": "guarantor_zip",
"placeholder": "Enter Zip",
"type": "text",
"htmlClass": "col-md-6 col-xs-6 col-sm-12"
},
{
"key": "guarantor_state",
"type": "select",
"titleMap": {
"AL": "Alabama",
"AK": "Alaska",
"AZ": "Arizona",
"AR": "Arkansas",
"CA": "California",
"CO": "Colorado",
"CT": "Connecticut",
"DE": "Delaware",
"DC": "District of Columbia",
"FL": "Florida",
"GA": "Georgia",
"HI": "Hawaii",
"ID": "Idaho",
"IL": "Illinois",
"IN": "Indiana",
"IA": "Iowa",
"KS": "Kansas",
"KY": "Kentucky",
"LA": "Louisiana",
"ME": "Maine",
"MD": "Maryland",
"MA": "Massachusetts",
"MI": "Michigan",
"MN": "Minnesota",
"MS": "Mississippi",
"MO": "Missouri",
"MT": "Montana",
"NE": "Nebraska",
"NV": "Nevada",
"NH": "New Hampshire",
"NJ": "New Jersey",
"NM": "New Mexico",
"NY": "New York",
"NC": "North Carolina",
"ND": "North Dakota",
"OH": "Ohio",
"OK": "Oklahoma",
"OR": "Oregon",
"PA": "Pennsylvania",
"RI": "Rhode Island",
"SC": "South Carolina",
"SD": "South Dakota",
"TN": "Tennessee",
"TX": "Texas",
"UT": "Utah",
"VT": "Vermont",
"VA": "Virginia",
"WA": "Washington",
"WV": "West Virginia",
"WI": "Wisconsin",
"WY": "Wyoming"
},
"htmlClass": "col-md-6 col-xs-6 col-sm-12"
},
{
"key": "card_front",
"title": "Upload Insurance Card (Front)",
"type": "attachments",
"id": "cardFrontArea",
"height": "100px",
"single": true,
"htmlClass": "col-md-12 col-xs-12 col-sm-12"
},
{
"key": "card_back",
"title": "Upload Insurance Card (Back)",
"type": "attachments",
"id": "cardBackArea",
"height": "100px",
"single": true,
"htmlClass": "col-md-12 col-xs-12 col-sm-12"
},
{
"key": "consent",
"htmlClass": "col-md-12 col-xs-12 col-sm-12",
"type": "checkbox",
"notitle": true,
"inlinetitle": "I give the <a target='_blank' href='https://api-vclinic.vsee.me/files/view/65f07a66-59b4-4b00-a111-05c10adc645d'>authorization to bill insurance</a>"
},
{
"type": "label",
"label": "Your insurance will be verified but we still need your credit card information in case of deductible or co payment requirements in the next screen."
}
]
}
}
}
]
}
]
},
{
name: "Insurance",
card_type: "secondary",
schema: {},
form: {}
}
] |
GET api_v3/users/{user_id}/insurances
Expand | |||||
---|---|---|---|---|---|
| |||||
|
POST api_v3/users/{user_id}/insurances/import
Post in array
If there is primary existed, update else insert
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
POST api_v3/users/{user_id}/insurances/{card_type|primary|secondary}
If the insurance schema doesn’t have card_type
, we should set it as primary
as default. ( Duong Dang )
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
GET api_v3/users/{user_id}/insurances/{card_type|primary|secondary}
Expand | |||||
---|---|---|---|---|---|
| |||||
|
DELETE api_v3/users/{user_id}/insurances/{card_type}
...
title | Response (204) |
---|
Eligibility check
POST api_v3/users/{user_id}/insurances/primary/eligibility/check
Check and return queue status and current eligibility status
Known issue: every post will submit new check (to optimize later)
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
GET api_v3/users/{user_id}/insurances/primary/eligibility
Return queue status and current eligibility status
Expand | |||||
---|---|---|---|---|---|
| |||||
|
...
title | Response 2 |
---|
...
language | json |
---|
...
Table of Contents |
---|
Create / update delete / retrieve insurance detail
Info |
---|
The following APIs can be called using patient’s token or Clinic Admin token |
GET api_v3/users/:user_id/insurances
Status | ||||
---|---|---|---|---|
|
This returns a list of insurance cards associated with this user
Expand | |||||
---|---|---|---|---|---|
| |||||
|
POST api_v3/users/{user_id}/insurances/import
Status | ||||
---|---|---|---|---|
|
Payload should include array of up to 2 insurance detail, one is
primary
and the other issecondary
If insurance type already exists, it will be overwritten
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
POST api_v3/users/{user_id}/insurances/{primary|secondary}
Status | ||||
---|---|---|---|---|
|
Update primary
or secondary
insurance
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
GET api_v3/users/{user_id}/insurances/{primary|secondary}
Status | ||||
---|---|---|---|---|
|
Retrieve primary
or secondary
insurance
Expand | |||||
---|---|---|---|---|---|
| |||||
|
DELETE api_v3/users/{user_id}/insurances/{primary|secondary}
Status | ||||
---|---|---|---|---|
|
Expand | ||
---|---|---|
| ||
|
Eligibility check
POST api_v3/users/{user_id}/insurances/primary/eligibility/check
Status | ||||
---|---|---|---|---|
|
Check and return queue status and current eligibility status
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
GET api_v3/users/{user_id}/insurances/primary/eligibility
Status | ||||
---|---|---|---|---|
|
Return queue status and current eligibility status
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Claims Center
GET api_v3/reports/claims?from_date=2024-09-02&to_date=2024-09-05
Status | ||||
---|---|---|---|---|
|
Return list of visits with other data that is relevant for claim
Retrieve data list
GET api_v3/insurances/list/insurers
Sample request
Code Block | ||
---|---|---|
| ||
curl --location 'https://api-vclinic.vseepreview.com/vc/stable/api_v3/insurances/list/insurers' \
--header 'X-AccountCode: vclinic' |
Sample response
Expand | |||||
---|---|---|---|---|---|
| |||||
|
GET api_v3/insurances/list/billing_modifiers
Sample request
Code Block | ||
---|---|---|
| ||
curl --location 'https://api-vclinic.vseepreview.com/vc/stable/api_v3/insurances/list/billing_modifiers' \
--header 'X-AccountCode: vclinic' |
Sample response
Expand | |||||
---|---|---|---|---|---|
| |||||
|
GET api_v3/insurances/list/dxs
Sample request
Code Block | ||
---|---|---|
| ||
curl --location 'https://api-vclinic.vseepreview.com/vc/stable/api_v3/insurances/list/dxs' \
--header 'X-AccountCode: vclinic' |
Sample response
Expand | |||||
---|---|---|---|---|---|
|
GET api_v3/insurances/list/procedures
Sample request
Code Block | ||
---|---|---|
| ||
curl --location 'https://api-vclinic.vseepreview.com/vc/stable/api_v3/insurances/list/procedures' \
--header 'X-AccountCode: vclinic' |
Sample response
Expand | |||||
---|---|---|---|---|---|
|