Version: 2.2
Path | Operation | Description |
---|---|---|
/meta/allergy/allergens | GET |
Lookup Allergens by search term, e.g. "CHOCOLATE" |
/meta/allergy/signSymptoms | GET |
Lookup a Sign/Symptom |
/meta/location | GET |
Lookup Clinics/Locations |
/meta/problem/categories | GET |
Shows array of problem categories for user to select from |
/meta/problem/lookup | GET |
Perform lexical search for problems |
/meta/user/ | GET |
Return all users |
/meta/user/authenticate | POST |
Authenticates user |
/meta/vital/type | GET |
Retrieve list of vital types, with categories & qualifiers associated with types |
/patient/allergy | GET |
List patient allergies, or return NKA message. |
POST |
Create a new Allergy and assign it to current patient |
|
/patient/allergy/setNKA | POST |
Mark a patient's record as having 'No Known Allergies' |
/patient/allergy/{allergyId} | DELETE |
Remove allergy |
GET |
Lookup Allergy information |
|
PUT |
Update an allergy. |
|
/patient/data | GET |
Get list of patients |
/patient/data/info | GET |
Get information data for a previously selected patient |
/patient/data/report | GET |
Lookup report data for a previously selected patient |
/patient/data/select | GET |
Select a specific patient |
/patient/problem | GET |
Return detailed problem data |
POST |
Creates problem |
|
/patient/problem/unremove/{problemId} | PUT |
Unremove problem associated with id |
/patient/problem/{problemId} | DELETE |
Remove problem associated with id |
GET |
Return detailed single problem data |
|
PUT |
Updates problem associated with object |
|
/patient/vital | GET |
Lists all vitals |
POST |
Creates a single vital |
|
/patient/vital (MULTIPLE) | POST |
Creates multiple vitals |
/patient/vital/{vitalId} | DELETE |
Remove vital associated with id |
GET |
Lookup vital associated with id |
application/x-www-form-urlencoded
search | Allergy term to be looked up |
query | string |
application/json
search complete
{
"ALLERGENS": [
{
"allergyType": "DF",
"id": "urn:national:120_82:3",
"label": "CHOCOLATE",
"synonymMatches": [
"CHOCOLATES"
]
}
],
"DRUG CLASSES": [
],
"DRUG INGREDIENTS": [
{
"allergyType": "D",
"id": "urn:national:50_416:2014",
"label": "CHOCOLATE FLAVORING"
}
],
"GENERICS": [
],
"GENERICS TRADENAME": [
{
"allergyType": "D",
"id": "urn:national:50_6:3811",
"label": "CHOCOLATE LAXATIVE"
}
]
}
list of allergens associated with the search
list of generic allergens associated with the search
list of NDC/UPN allergens associated with the search
list of drug ingredients associated with the search
list of drug classes associated with the search
Error
Lookup sign/symptom by search term in optional sort direction (1 for ascending or -1 for descending)
application/x-www-form-urlencoded
searchTerm | Sign/symptom term to be looked up |
query | string | |
direction | Sort order of list (1=Ascending, -1=Descending) |
query | string , x ∈ { 1 (default) , -1 } |
application/json
Array of allergy signs and symptoms
Error
Lookup Clinics/Locations by search term, sorted in ascending or descending order
application/x-www-form-urlencoded
search | Clinic/Location name to look up |
query | string | |
direction | Sort order of list (1=Ascending, -1=Descending) |
query | string , x ∈ { 1 (default) , -1 } |
application/json
search complete
Returns array of problem categories for user to select from
id | Clinical Location URN ID |
query | string |
List of Problem Categories
Error
Lookup expression data entries associated with problems that match a particu search term. The function will return two sets of results, PRIMARY results, which are problems that lexically match the search term, and SECONDARY results, which are problems whose terminology synonyms lexically match the search term
search | search term to use as query on problem data |
query | string | |
synonyms | True to include synonym expressions, false for no synonyms |
query | boolean |
application/json
search complete
Error when searching for problem.
Lookup all users with matching station Id
application/x-www-form-urlencoded
search | User name to lookup |
query | string | |
limit | Maximum number of Users to query for |
query | string 44 |
application/json
search complete
Error when searching for users
Associates Client Address to Current Session
Problem Object contains data required to add new problem to selected user
Authentication successful
Error
vitalTypes | Comma-delimited list of vital type abbreviations to look up. If this parameter is not specified, then all vital types available will be returned |
query | string |
application/json
Array of vital type objects, which should also contain categories and qualifiers
Error
application/x-www-form-urlencoded
application/json
successfully fetched list of allergies
NKA error message
Error message
Internal Server error
application/x-www-form-urlencoded
Object describing the Allergy to create
application/json
successfully created Allergy
{
"allergyId": "urn:vista:999:120_8:1",
"success": "Successfully created allergy ID urn:vista:999:120_8:1"
}
Success message
URN ID of created allergy
Internal server error
Creates a 'No Known Allergies' Allergy Assessment record or returns an error message if patient has active allergies or already has an NKA assessment
application/x-www-form-urlencoded
application/json
Successfully created Allergy Assessment
Success message
Internal server error
Marked allergy as removed, with optional comment
application/x-www-form-urlencoded
allergyId | Allergy URN ID |
path | string | |
comment | Optional comment/reason for allergy removal |
query | string |
application/json
Successfully marked allergy as removed
Success message
Error - Allergy already marked as removed
Error message
Internal server error
Return information about a specified allergy. Note - filtered out chartMarked & idBandMarked properties
application/x-www-form-urlencoded
allergyId | Allergy URN ID |
path | integer |
application/json
successfully looked up Allergy
Internal server error
Update the specified allergy properties.
application/x-www-form-urlencoded
Allergy Object with ID & properties to change.
application/json
Successfully updated allergy
Success message
Internal server error
Given a search term, list patients before (-1) or after (1) the search term index
application/x-www-form-urlencoded
search | Patient name to lookup |
query | string | |
direction | Direction of search (-1=Before search term, 1=After search term) |
query | string , x ∈ { 1 (default) , -1 } | |
limit | Maximum number of Patients to query for |
query | string 44 |
application/json
listing complete
Lookup current patient information for the patient selected via the select patient endpoint
application/x-www-form-urlencoded
application/json
lookup complete
This assumes that you have already selected a patient with the select patient routine
application/x-www-form-urlencoded
application/json
Lookup complete
Pick a patient for the current user session context. All patient operations from this point on will use the selected patient.
id | Patient URN identifier, retrieved from 'listPatients' |
query | string |
application/json
Patient Information
Returns problems available
activeFilter | Filter criteria relating to active/inactive status |
query | string |
Success, list of problems
"ACTIVE"
"PERMANENT"
"73211009"
"121589010"
"10D"
"ACUTE"
"Cisplatin Injection (50 mg) (SCT 73211009)"
"Puncture wound with foreign body of oral cavity, subsequent encounter"
"urn:vista:999:9000011:1"
"CLInicB"
"ALEXANDER,ROBERT"
"ALEXANDER,ROBERT"
"Diabetes mellitus"
"VISTA HEALTH CARE"
"Cisplatin Injection (50 mg)"
"CARTER,DAVID"
"S01.542D"
"Cisplatin Injection (50 mg) (SCT 73211009)"
{
"isAgentOrangeExposure": false,
"isCombatVeteran": false,
"isHeadAndOrNeckCancer": false,
"isIonizingRadiationExposure": false,
"isMilitarySexualTrauma": false,
"isPersianGulfExposure": false,
"isShipboardHazardDefense": false
}
Error
Creates an new problem record
Problem Object contains data required to add new problem to selected user
"urn:national:80:522489"
"urn:national:757_01:7130783"
"Cisplatin Injection"
"73211009"
"121589010"
"10D"
"urn:vista:999:4:2957"
"urn:vista:999:44:8"
"urn:vista:999:200:64"
"urn:vista:999:200:64"
"2018-03-06T00:53:03.414Z"
"2018-03-06T00:53:03.414Z"
"2018-03-06T00:53:03.414Z"
"2018-03-06T00:53:03.414Z"
"2018-03-06T00:53:03.414Z"
"This is a comment"
"2018-03-06T00:53:03.414Z"
Created
Error
Unremoves an existing problem record
problemId | Problem URN ID |
path | string |
Success
Error
Removes an existing problem record
problemId | Problem URN ID |
path | string |
Success
Error
Returns single problem available
problemId | Problem URN ID |
path | string |
Success, list of problems
"ACTIVE"
"PERMANENT"
"73211009"
"121589010"
"10D"
"ACUTE"
"Cisplatin Injection (50 mg) (SCT 73211009)"
"Puncture wound with foreign body of oral cavity, subsequent encounter"
"urn:vista:999:9000011:1"
"CLInicB"
"ALEXANDER,ROBERT"
"ALEXANDER,ROBERT"
"Diabetes mellitus"
"VISTA HEALTH CARE"
"Cisplatin Injection (50 mg)"
"CARTER,DAVID"
"S01.542D"
"Cisplatin Injection (50 mg) (SCT 73211009)"
Error
Updates an existing problem record
Problem Object contains data required to update a patient's problem record
"urn:vista:999:9000011:1"
"urn:national:757_01:7130783"
"Cisplatin Injection"
"73211009"
"121589010"
"urn:national:80:522489"
"10D"
"urn:vista:999:4:2957"
"urn:vista:999:44:8"
"urn:vista:999:200:64"
"urn:vista:999:200:64"
"2018-03-06T00:53:03.414Z"
"2018-03-06T00:53:03.414Z"
"2018-03-06T00:53:03.414Z"
"2018-03-06T00:53:03.414Z"
"2018-03-06T00:53:03.414Z"
problemId | Problem URN ID |
path | string |
Success
Error
Returns list of vitals objects associated with context patient
Vital list options to specify search
"2017-01-01T18:06:04.493Z"
"2017-08-01T18:06:04.493Z"
-1
[
"BLOOD PRESSURE",
"TEMPERATURE"
]
List of vitals
Error
Recorded vital data including date/time of measurements, hospital location, provider information, value, vital type, and units of measurements.
Vital measurements including date/time, vital type, hospital location, and measurement value
Successfully created vital
Internal server error
Recorded multiple vital data including date/time of measurements, hospital location, provider information, value, vital type, and units of measurements.
application/x-www-form-urlencoded
Multiple vital measurements including date/time, vital type, hospital location, and measurement value
application/json
Successfully created vitals
Internal server error
Removes an existing Vital record
vitalId | Vital URN ID to search for |
path | string |
Success
Error
Returns single vital object associated with the context object
vitalId | Vital URN ID |
path | string |
Single vital object
Time vitals was taken
"2019-01-01T18:06:04.493Z"
Time vitals was entered
"2018-04-24T19:39:48.204Z"
Value of vital measurement
"32"
Unit of vital measurement
"in"
Metric unit of vital measurement
"cm"
Metric value of vital measurement
"81.28"
Vital id
"urn:vista:999:120_5:2"
Provider name
"ALEXANDER,ROBERT"
Name of vital type
"CIRCUMFERENCE/GIRTH"
Hospital where vital was taken
"CLINICX"
Error
URN ID of the allergen
Display name of the allergen
Type of allergy (D=Drug, F=Food, O=Other)
List of synonym matches
{
"allergySeverity": "MODERATE",
"allergyType": "FOOD",
"comments": [
"don't give him shellfish, either..."
],
"dateOccurred": "2016-02-18",
"mechanism": "ALLERGY",
"observedOrHistorical": "OBSERVED",
"reactant": {
"id": "urn:national:120_82:5",
"label": "SHELLFISH"
},
"reactions": [
{
"reaction": {
"id": "urn:national:120_83:1",
"label": "HIVES"
}
},
{
"reaction": {
"id": "urn:national:120_83:2",
"label": "ITCHING,WATERING EYES"
}
}
],
"type": "Allergy"
}
D=DRUG, F=FOOD, DF=DRUG, FOOD, O=OTHER
o=OBSERVED, h=HISTORICAL
Allergy mechanism (A=ALLERGY, P=PHARMACOLOGIC, U=UNKNOWN)
successfully looked up Allergy
{
"allergyId": "urn:vista:999:120_8:1",
"success": "Successfully created allergy ID urn:vista:999:120_8:1"
}
Allergy mechanism (A=ALLERGY, P=PHARMACOLOGIC, U=UNKNOWN)
D=DRUG, F=FOOD, DF=DRUG, FOOD, O=OTHER
Date entered into system
Date occurred
true if verified/signed, otherwise false
Observed or Historical Allergy?
List of comment objects
List of reaction objects
{
"allergyList": [
{
"allergySeverity": "MODERATE",
"dateTimeEntered": "2018-08-20T19:59:22.563Z",
"enteredAtFacility": {
"id": "urn:vista:999:4:2957",
"label": "VISTA HEALTH CARE"
},
"id": "urn:vista:999:120_8:1",
"reactant": {
"id": "urn:national:120_82:5",
"label": "SHELLFISH"
},
"reactions": [
"HIVES - ITCHING,WATERING EYES"
]
}
]
}
URN ID of Allergy
Allergy reactant
URN ID of reactant
Display name of reactant
the division/facility that the allergy was recorded at
URN ID of division
Display name of division
date/time entered into database
List of reactions
Display name of reaction
URN ID of the Allergy to update
Clinic/Location properties
[
{
"label": "Clinic2",
"urn": "urn:vista:999:44:5"
},
{
"label": "VISTA HEALTH CARE",
"urn": "urn:vista:999:44:3"
}
]
URN ID of Clinic/Location
Display name of Clinic/Location
A single comment
Comment string
Date entered into system
Display name of author
URN ID of drug ingredient
display name of drug ingredient
URN ID of the ingredient
Display name of the ingredient
Originator information
URN ID of Originator
display name of Originator
URN ID of the allergen
Display name of the allergen
Type of allergy (D=Drug, F=Food, O=Other)
Patient information
{
"dateOfBirth": "1981-03-02T00:00:00.000Z",
"id": "urn:vista:999:2:25",
"isVeteran": true,
"name": "CARTER,DAVID",
"sex": "MALE",
"socialSecurityNumber": "000000113"
}
URN ID of Patient
Display name of Patient
Patient name and ID
[
{
"id": "urn:vista:999:2:22",
"name": "EIGHTEEN,PATIENT R"
},
{
"id": "urn:vista:999:2:17",
"name": "EIGHT,PATIENT H"
},
{
"id": "urn:vista:999:2:25",
"name": "CARTER,DAVID"
}
]
URN ID of Patient
Display name of Patient
Patient information
URN ID of Patient
Display name of Patient
Patient select info
URN ID of the patient
"urn:vista:999:2:25"
Display name of the patient
"CARTER,DAVID"
Gender of the patient
"MALE"
The patient type with respect to treatment at a VA facility
"NSC VETERAN"
ISO Date string representing the patient's date of birth
"1981-03-02T00:00:00.000Z"
"000000113"
"VA-NATIONAL PROBLEM SELECTION LIST"
"National"
"VA-PRIMARY CARE"
1
"Primary Care (VA)"
true
URN ID of the problem type
"urn:national:757_01:7001949"
Textual description of the problem type
"Benign essential hypertension"
"3135013"
"SCT"
"4448006"
"SCT"
true
"Lumbar puncture headache"
"1786602019"
Reactant information
URN ID of reactant
display name of reactant
Reactant details
List of drug classes
List of drug ingredients
A reaction object
URN ID of reaction
Display name of reaction
"urn:national:120_83:425"
"UPPER AIRWAY OBSTRUCTION"
"ACUTE UPPER AIRWAY OBSTRUCTION"
"2019-01-01T18:06:04.493Z"
"urn:national:120_51:20"
"urn:vista:999:44:6"
"32"
"urn:vista:999:200:20"
[
"urn:national:120_52:1",
"urn:national:120_52:51"
]
"urn:national:120_52:1"