Page Comparison

...

Steps

Example Request

Example Response

1

Contact the VSee team to configure which insurers you want to support. Once configured, use https://vsee.atlassian.net/wiki/spaces/VD/pages/55083127#GET-%2Finsurance%2F to pull the list which will also contain insurer_id.

Code Block
curl --location --request GET 'https://api-vclinic.vseepreview.com/vc/dev/api_v3/insurances/' \ --header 'X-ApiToken: xxxx'

Code Block

language	json

{
    "data": {
        "insurers": [
            {
                "id": "car7551",
                "name": "AETNA"
            },
            {
                "id": "car7414",
                "name": "AETNA BETTER HEALTH OF ILLINOIS"
            },
            {
                "id": "car11406",
                "name": "ANTHEM BLUE SHIELD"
            },
            {
                "id": "car7147",
                "name": "CIGNA HEALTH CARE"
            },
            {
                "id": "car7580",
                "name": "MONTGOMERY HEALTH INSURANCE"
            },
            {
                "id": "car7556",
                "name": "HEALTH CHOICE ARIZONA"
            }
        ]
    }
}

2

Create a VSee Clinic user via https://vsee.atlassian.net/wiki/spaces/VD/pages/14942243/User+API#POST-%2Fusers%2Fsso

As a response you will receive user_id patient data on VSee side.

Code Block

curl --location --request POST 'https://api-vclinic.vseepreview.com/vc/dev/api_v3/users/sso' \
--header 'X-AccountCode: vclinic' \
--header 'X-ApiKey: xxx' \
--header 'X-ApiSecret: xxx' \
--header 'X-ApiToken: xxx' \
--form 'first_name="Edward"' \
--form 'last_name="VSee"' \
--form 'type="200"' \
--form 'code="edward+001.vclinic@vseelab.com"' \
--form 'email="edward+001.vclinic@vseelab.com"' \
--form 'dob="1986-01-01"' \
--form 'gender="1"' \
--form 'street_addr="2868 Tully Street"' \
--form 'state="Detroit"' \
--form 'city="MI"' \
--form 'zip="48226"'

Code Block

language	json

{
    "data": {
        "id": "132407",
        "code": "edward+001.vclinic@vseelab.com",
        "first_name": "Edward",
        "last_name": "VSee",
        "full_name": "Edward VSee",
        "username": "edward+001.vclinic@vseelab.com",
        "vseeid": "ccpreview+6258012d656449b8b5e73ad964457b1f",
        "dob": "1986-01-01",
        "email": "edward+001.vclinic@vseelab.com",
        "gender": 1,
        "active": true,
        "tos": false,
        "status": 20,
        "subtype": "",
        "street_addr": "2868 Tully Street",
        "state": "Detroit",
        "city": "MI",
        "zip": "48226",
        "timezone": "America/Los_Angeles",
        "email_verified": true,
        "account_code": "vclinic",
        "clinics": [
            "vclinic"
        ],
        "created": 1649934637,
        "token": {
            "user_id": "132407",
            "token": "xxxx",
            "expiry": 1650021037,
            "created": 1649934637,
            "user_type": "200",
            "refresh_token": {
                "user_id": "132407",
                "token": "xxxx",
                "expiry": 1652526637,
                "created": 1649934637
            }
        }
    }
}

3

Some user fields are required if you want to use the insurance API. Use https://vsee.atlassian.net/wiki/spaces/VD/pages/14942243/User+API#POST-%2Fme to update the user’s insurance information based on user_id patient data. Use the data.token.token from SSO response in Step 2 for the X-ApiToken header.

Code Block

curl --location --request POST 'https://api-vclinic.vseepreview.com/vc/dev/api_v3/me.json' \
--header 'X-ApiToken: xxxx' \
--form 'insurance.primary_carrier_code="car7556"' \
--form 'insurance.respparty="self"' \
--form 'insurance.primary_subscriber_num="23423410000022"' \
--form 'insurance.primary_group_number="test 310000022"' \
--form 'insurance.secondary_carrier_code="car11406"' \
--form 'insurance.secondary_group_number="asdasd10000022"' \
--form 'insurance.secondary_subscriber_num="aaaaa10000022"'

Code Block

language	json

{
    "data": {
        "id": "132407",
        "code": "edward+001.vclinic@vseelab.com",
        "first_name": "Edward",
        "last_name": "VSee",
        "full_name": "Edward VSee",
        "username": "edward+001.vclinic@vseelab.com",
        "vseeid": "ccpreview+6258012d656449b8b5e73ad964457b1f",
        "dob": "1986-01-01",
        "email": "edward+001.vclinic@vseelab.com",
        "gender": 1,
        "active": true,
        "tos": false,
        "status": 20,
        "subtype": "",
        "street_addr": "2868 Tully Street",
        "state": "Detroit",
        "city": "MI",
        "zip": "48226",
        "timezone": "America/Los_Angeles",
        "email_verified": true,
        "insurance": {
            "primary": {
                "carrier_code": "car7556",
                "subscriber_num": "234234",
                "insurance_order": 1
            },
            "secondary": {
                "carrier_code": "car11406",
                "group_number": "asdasd",
                "subscriber_num": "aaaaa",
                "insurance_order": 2
            },
            "patient": {
                "respparty": "self"
            }
        },
        "account_code": "vclinic",
        "clinics": [
            "vclinic"
        ],
        "created": 1649934637
    }
}

4

Run Insurance API (Draft) | POST-/users/:id/:carrier_code/eligibility to trigger the eligibility check for the given user_id. The eligibility check may take some time. A cron job will be created. The cron job will run after 10 seconds and the response will be saved in the user_data.insurance.{primary/secondary}.eligibility_response

Use the data.token.token from SSO response in Step 2 for the X-ApiToken header.

Code Block
curl --location --request POST 'https://api-vclinic.vseepreview.com/vc/dev/api_v3/users/132407/car7556/eligibility' \ --header 'X-AccountCode: vclinic' \ --header 'X-ApiToken: xxxx'

Code Block

language	json

{
    "data": {
        "eligibility_id": "2505465",
        "carrier_code": "car7556"
    }
}

5

Receive a webhook request with eligibility_response message which will contain the result of the eligibility check. Skip this step if the clinic doesn’t have webhook

Code Block

language	json

{
  "id": "62583ab3-8cfc-4a47-b6c9-272850e631f8",
  "type": "eligibility.checked",
  "created": 1649949363,
  "account_code": "vclinic",
  "data": {
    "eligibility_id": "2505464",
    "member_id": "132407",
    "eligibility_response": "No response received by clearinghouse",
    "external_member_id": "5991794"
  }
}

6

If the user is eligible, trigger a claim submission process for the user_id https://vsee.atlassian.net/wiki/spaces/VD/pages/55083127#POST-%2Finsurance%2Fclaims

TDB

TBD

7

Receive a webhook request which will contain the result of the claim.

TBD

...

Versions Compared

Old Version 38

New Version 39

Key