Validate Patient Processing Panel
curl --request POST \
--url https://processing-request-staging.connectivehealth.io/v2/patient-data/validate \
--header 'Content-Type: application/json' \
--header 'apiKey: <api-key>' \
--data '
{
"patientProcessingRequests": [
{
"patient": {
"mrn": {
"root": "1.2.3.4",
"extension": "ABC123"
},
"name": {
"family": "Johnson",
"given": [
"John",
"Aaron"
],
"prefix": "Mr.",
"suffix": "Jr."
},
"birthDate": "1992-04-09",
"addresses": [
{
"lines": [
"123 Main St",
"Suite 517"
],
"city": "Minneapolis",
"state": "MN",
"zip": "55401"
}
],
"contactPoints": [
{
"value": "9525551234",
"contactPointSystem": "PHONE",
"contactPointUse": "HOME"
}
]
},
"requestingProvider": {
"npi": "1414912117",
"name": {
"family": "Johnson",
"given": [
"John",
"Aaron"
],
"prefix": "Mr.",
"suffix": "Jr."
}
},
"upcomingAppointmentDate": "2025-11-05",
"enrollmentDate": "2025-11-05",
"clinicName": "Simple Clinic Name",
"clinicNpi": "1414912117",
"responseDirectAddress": "contact@yourdomain.com",
"responseFriendlyName": "Heart Clinic",
"diagnoses": [
{
"code": "E66.01",
"codeSystem": "2.16.840.1.113883.6.90",
"displayName": "Morbid (severe) obesity due to excess calories",
"active": true,
"date": "2022-12-12"
}
],
"procedures": [
{
"date": "2022-12-12",
"code": {
"code": "44970",
"codeSystem": "2.16.840.1.113883.6.12",
"codeSystemName": "CPT",
"displayName": "Laparoscopy, surgical, appendectomy"
},
"targetSite": {
"code": "66754008",
"codeSystem": "2.16.840.1.113883.6.96",
"codeSystemName": "SNOMED CT",
"displayName": "Appendix structure"
},
"note": "Procedure was well tolerated"
}
],
"immunizations": [
{
"date": "2024-10-01",
"code": {
"code": "150",
"codeSystem": "2.16.840.1.113883.12.292",
"codeSystemName": "CVX",
"displayName": "Influenza, injectable, quadrivalent, preservative free"
}
}
],
"medications": [
{
"active": true,
"nameCode": {
"code": "6809",
"codeSystem": "2.16.840.1.113883.6.88",
"codeSystemName": "RxNorm",
"displayName": "metFORMIN"
},
"classCode": {
"code": "N0000175565",
"codeSystem": "2.16.840.1.113883.6.345",
"codeSystemName": "MED-RT",
"displayName": "Biguanide"
},
"scheduleCode": {
"code": "IV",
"codeSystem": "2.16.840.1.113883.12.477",
"codeSystemName": "Controlled Substance Schedule",
"displayName": "Schedule IV"
},
"medicationRequests": [
{
"code": {
"code": "861007",
"codeSystem": "2.16.840.1.113883.6.88",
"codeSystemName": "RxNorm",
"displayName": "metFORMIN hydrochloride 500 MG Oral Tablet"
},
"form": {
"code": "C42998",
"codeSystem": "2.16.840.1.113883.3.26.1.1",
"codeSystemName": "NCI Thesaurus",
"displayName": "tablet"
},
"route": {
"code": "C38288",
"codeSystem": "2.16.840.1.113883.3.26.1.1",
"codeSystemName": "NCI Thesaurus",
"displayName": "oral"
},
"prescribedDate": "2023-12-02",
"initialFillQuantity": 10,
"numberOfRefillsAllowed": 0,
"timingEvent": "QD",
"frequencyUnit": "d",
"frequencyValue": 1,
"dosageInstruction": {
"text": "take 1 tablet by mouth once daily",
"strengthUnit": "mg",
"strengthValue": 100,
"amountUnit": "puffs",
"amountValue": 2
}
}
]
}
],
"clinicalNotes": [
{
"lines": [
"The patient was pleasant",
"Recommend following up in 2 weeks"
],
"date": "2022-12-12",
"code": {
"code": "11506-3",
"codeSystem": "2.16.840.1.113883.6.1",
"codeSystemName": "LOINC",
"displayName": "Progress Note"
}
}
],
"directives": {
"newPatient": false,
"useCase": "HIGH_RISK",
"diagnosticCategories": {
"autoimmune": false,
"bariatric": false,
"behavioral": false,
"cardiovascular": false,
"dental": false,
"dermatological": false,
"endocrinological": false,
"gastroenterological": false,
"generalInformation": false,
"generalSurgery": false,
"hematological": false,
"infectious": false,
"lymphatic": false,
"mens": false,
"metabolic": false,
"musculoskeletal": false,
"neonatological": false,
"neurological": false,
"nutritional": false,
"oncological": false,
"ophthalmic": false,
"otolaryngological": false,
"pain": false,
"postSurgery": false,
"pulmonary": false,
"renal": false,
"spinal": false,
"stroke": false,
"toxicological": false,
"urological": false,
"womens": false
},
"medicationsOfInterest": [
{
"active": true,
"nameCode": {
"code": "6809",
"codeSystem": "2.16.840.1.113883.6.88",
"codeSystemName": "RxNorm",
"displayName": "metFORMIN"
},
"classCode": {
"code": "N0000175565",
"codeSystem": "2.16.840.1.113883.6.345",
"codeSystemName": "MED-RT",
"displayName": "Biguanide"
},
"scheduleCode": {
"code": "IV",
"codeSystem": "2.16.840.1.113883.12.477",
"codeSystemName": "Controlled Substance Schedule",
"displayName": "Schedule IV"
},
"medicationRequests": [
{
"code": {
"code": "861007",
"codeSystem": "2.16.840.1.113883.6.88",
"codeSystemName": "RxNorm",
"displayName": "metFORMIN hydrochloride 500 MG Oral Tablet"
},
"form": {
"code": "C42998",
"codeSystem": "2.16.840.1.113883.3.26.1.1",
"codeSystemName": "NCI Thesaurus",
"displayName": "tablet"
},
"route": {
"code": "C38288",
"codeSystem": "2.16.840.1.113883.3.26.1.1",
"codeSystemName": "NCI Thesaurus",
"displayName": "oral"
},
"prescribedDate": "2023-12-02",
"initialFillQuantity": 10,
"numberOfRefillsAllowed": 0,
"timingEvent": "QD",
"frequencyUnit": "d",
"frequencyValue": 1,
"dosageInstruction": {
"text": "take 1 tablet by mouth once daily",
"strengthUnit": "mg",
"strengthValue": 100,
"amountUnit": "puffs",
"amountValue": 2
}
}
]
}
],
"riskAdjustmentConfiguration": {},
"careManagementConfiguration": {},
"qualityMeasureConfiguration": {
"asOfDateOverride": "2025-12-31"
}
}
}
],
"batchId": "BATCH-123",
"patientPanelDirectives": {
"requestMedicationHistory": true,
"deliverableDocuments": [
"PATIENT_CARE_SUMMARY",
"QUALITY_MEASURES_SUMMARY"
],
"principalOid": "<string>"
}
}
'import requests
url = "https://processing-request-staging.connectivehealth.io/v2/patient-data/validate"
payload = {
"patientProcessingRequests": [
{
"patient": {
"mrn": {
"root": "1.2.3.4",
"extension": "ABC123"
},
"name": {
"family": "Johnson",
"given": ["John", "Aaron"],
"prefix": "Mr.",
"suffix": "Jr."
},
"birthDate": "1992-04-09",
"addresses": [
{
"lines": ["123 Main St", "Suite 517"],
"city": "Minneapolis",
"state": "MN",
"zip": "55401"
}
],
"contactPoints": [
{
"value": "9525551234",
"contactPointSystem": "PHONE",
"contactPointUse": "HOME"
}
]
},
"requestingProvider": {
"npi": "1414912117",
"name": {
"family": "Johnson",
"given": ["John", "Aaron"],
"prefix": "Mr.",
"suffix": "Jr."
}
},
"upcomingAppointmentDate": "2025-11-05",
"enrollmentDate": "2025-11-05",
"clinicName": "Simple Clinic Name",
"clinicNpi": "1414912117",
"responseDirectAddress": "contact@yourdomain.com",
"responseFriendlyName": "Heart Clinic",
"diagnoses": [
{
"code": "E66.01",
"codeSystem": "2.16.840.1.113883.6.90",
"displayName": "Morbid (severe) obesity due to excess calories",
"active": True,
"date": "2022-12-12"
}
],
"procedures": [
{
"date": "2022-12-12",
"code": {
"code": "44970",
"codeSystem": "2.16.840.1.113883.6.12",
"codeSystemName": "CPT",
"displayName": "Laparoscopy, surgical, appendectomy"
},
"targetSite": {
"code": "66754008",
"codeSystem": "2.16.840.1.113883.6.96",
"codeSystemName": "SNOMED CT",
"displayName": "Appendix structure"
},
"note": "Procedure was well tolerated"
}
],
"immunizations": [
{
"date": "2024-10-01",
"code": {
"code": "150",
"codeSystem": "2.16.840.1.113883.12.292",
"codeSystemName": "CVX",
"displayName": "Influenza, injectable, quadrivalent, preservative free"
}
}
],
"medications": [
{
"active": True,
"nameCode": {
"code": "6809",
"codeSystem": "2.16.840.1.113883.6.88",
"codeSystemName": "RxNorm",
"displayName": "metFORMIN"
},
"classCode": {
"code": "N0000175565",
"codeSystem": "2.16.840.1.113883.6.345",
"codeSystemName": "MED-RT",
"displayName": "Biguanide"
},
"scheduleCode": {
"code": "IV",
"codeSystem": "2.16.840.1.113883.12.477",
"codeSystemName": "Controlled Substance Schedule",
"displayName": "Schedule IV"
},
"medicationRequests": [
{
"code": {
"code": "861007",
"codeSystem": "2.16.840.1.113883.6.88",
"codeSystemName": "RxNorm",
"displayName": "metFORMIN hydrochloride 500 MG Oral Tablet"
},
"form": {
"code": "C42998",
"codeSystem": "2.16.840.1.113883.3.26.1.1",
"codeSystemName": "NCI Thesaurus",
"displayName": "tablet"
},
"route": {
"code": "C38288",
"codeSystem": "2.16.840.1.113883.3.26.1.1",
"codeSystemName": "NCI Thesaurus",
"displayName": "oral"
},
"prescribedDate": "2023-12-02",
"initialFillQuantity": 10,
"numberOfRefillsAllowed": 0,
"timingEvent": "QD",
"frequencyUnit": "d",
"frequencyValue": 1,
"dosageInstruction": {
"text": "take 1 tablet by mouth once daily",
"strengthUnit": "mg",
"strengthValue": 100,
"amountUnit": "puffs",
"amountValue": 2
}
}
]
}
],
"clinicalNotes": [
{
"lines": ["The patient was pleasant", "Recommend following up in 2 weeks"],
"date": "2022-12-12",
"code": {
"code": "11506-3",
"codeSystem": "2.16.840.1.113883.6.1",
"codeSystemName": "LOINC",
"displayName": "Progress Note"
}
}
],
"directives": {
"newPatient": False,
"useCase": "HIGH_RISK",
"diagnosticCategories": {
"autoimmune": False,
"bariatric": False,
"behavioral": False,
"cardiovascular": False,
"dental": False,
"dermatological": False,
"endocrinological": False,
"gastroenterological": False,
"generalInformation": False,
"generalSurgery": False,
"hematological": False,
"infectious": False,
"lymphatic": False,
"mens": False,
"metabolic": False,
"musculoskeletal": False,
"neonatological": False,
"neurological": False,
"nutritional": False,
"oncological": False,
"ophthalmic": False,
"otolaryngological": False,
"pain": False,
"postSurgery": False,
"pulmonary": False,
"renal": False,
"spinal": False,
"stroke": False,
"toxicological": False,
"urological": False,
"womens": False
},
"medicationsOfInterest": [
{
"active": True,
"nameCode": {
"code": "6809",
"codeSystem": "2.16.840.1.113883.6.88",
"codeSystemName": "RxNorm",
"displayName": "metFORMIN"
},
"classCode": {
"code": "N0000175565",
"codeSystem": "2.16.840.1.113883.6.345",
"codeSystemName": "MED-RT",
"displayName": "Biguanide"
},
"scheduleCode": {
"code": "IV",
"codeSystem": "2.16.840.1.113883.12.477",
"codeSystemName": "Controlled Substance Schedule",
"displayName": "Schedule IV"
},
"medicationRequests": [
{
"code": {
"code": "861007",
"codeSystem": "2.16.840.1.113883.6.88",
"codeSystemName": "RxNorm",
"displayName": "metFORMIN hydrochloride 500 MG Oral Tablet"
},
"form": {
"code": "C42998",
"codeSystem": "2.16.840.1.113883.3.26.1.1",
"codeSystemName": "NCI Thesaurus",
"displayName": "tablet"
},
"route": {
"code": "C38288",
"codeSystem": "2.16.840.1.113883.3.26.1.1",
"codeSystemName": "NCI Thesaurus",
"displayName": "oral"
},
"prescribedDate": "2023-12-02",
"initialFillQuantity": 10,
"numberOfRefillsAllowed": 0,
"timingEvent": "QD",
"frequencyUnit": "d",
"frequencyValue": 1,
"dosageInstruction": {
"text": "take 1 tablet by mouth once daily",
"strengthUnit": "mg",
"strengthValue": 100,
"amountUnit": "puffs",
"amountValue": 2
}
}
]
}
],
"riskAdjustmentConfiguration": {},
"careManagementConfiguration": {},
"qualityMeasureConfiguration": { "asOfDateOverride": "2025-12-31" }
}
}
],
"batchId": "BATCH-123",
"patientPanelDirectives": {
"requestMedicationHistory": True,
"deliverableDocuments": ["PATIENT_CARE_SUMMARY", "QUALITY_MEASURES_SUMMARY"],
"principalOid": "<string>"
}
}
headers = {
"apiKey": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {apiKey: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
patientProcessingRequests: [
{
patient: {
mrn: {root: '1.2.3.4', extension: 'ABC123'},
name: {family: 'Johnson', given: ['John', 'Aaron'], prefix: 'Mr.', suffix: 'Jr.'},
birthDate: '1992-04-09',
addresses: [
{
lines: ['123 Main St', 'Suite 517'],
city: 'Minneapolis',
state: 'MN',
zip: '55401'
}
],
contactPoints: [{value: '9525551234', contactPointSystem: 'PHONE', contactPointUse: 'HOME'}]
},
requestingProvider: {
npi: '1414912117',
name: {family: 'Johnson', given: ['John', 'Aaron'], prefix: 'Mr.', suffix: 'Jr.'}
},
upcomingAppointmentDate: '2025-11-05',
enrollmentDate: '2025-11-05',
clinicName: 'Simple Clinic Name',
clinicNpi: '1414912117',
responseDirectAddress: 'contact@yourdomain.com',
responseFriendlyName: 'Heart Clinic',
diagnoses: [
{
code: 'E66.01',
codeSystem: '2.16.840.1.113883.6.90',
displayName: 'Morbid (severe) obesity due to excess calories',
active: true,
date: '2022-12-12'
}
],
procedures: [
{
date: '2022-12-12',
code: {
code: '44970',
codeSystem: '2.16.840.1.113883.6.12',
codeSystemName: 'CPT',
displayName: 'Laparoscopy, surgical, appendectomy'
},
targetSite: {
code: '66754008',
codeSystem: '2.16.840.1.113883.6.96',
codeSystemName: 'SNOMED CT',
displayName: 'Appendix structure'
},
note: 'Procedure was well tolerated'
}
],
immunizations: [
{
date: '2024-10-01',
code: {
code: '150',
codeSystem: '2.16.840.1.113883.12.292',
codeSystemName: 'CVX',
displayName: 'Influenza, injectable, quadrivalent, preservative free'
}
}
],
medications: [
{
active: true,
nameCode: {
code: '6809',
codeSystem: '2.16.840.1.113883.6.88',
codeSystemName: 'RxNorm',
displayName: 'metFORMIN'
},
classCode: {
code: 'N0000175565',
codeSystem: '2.16.840.1.113883.6.345',
codeSystemName: 'MED-RT',
displayName: 'Biguanide'
},
scheduleCode: {
code: 'IV',
codeSystem: '2.16.840.1.113883.12.477',
codeSystemName: 'Controlled Substance Schedule',
displayName: 'Schedule IV'
},
medicationRequests: [
{
code: {
code: '861007',
codeSystem: '2.16.840.1.113883.6.88',
codeSystemName: 'RxNorm',
displayName: 'metFORMIN hydrochloride 500 MG Oral Tablet'
},
form: {
code: 'C42998',
codeSystem: '2.16.840.1.113883.3.26.1.1',
codeSystemName: 'NCI Thesaurus',
displayName: 'tablet'
},
route: {
code: 'C38288',
codeSystem: '2.16.840.1.113883.3.26.1.1',
codeSystemName: 'NCI Thesaurus',
displayName: 'oral'
},
prescribedDate: '2023-12-02',
initialFillQuantity: 10,
numberOfRefillsAllowed: 0,
timingEvent: 'QD',
frequencyUnit: 'd',
frequencyValue: 1,
dosageInstruction: {
text: 'take 1 tablet by mouth once daily',
strengthUnit: 'mg',
strengthValue: 100,
amountUnit: 'puffs',
amountValue: 2
}
}
]
}
],
clinicalNotes: [
{
lines: ['The patient was pleasant', 'Recommend following up in 2 weeks'],
date: '2022-12-12',
code: {
code: '11506-3',
codeSystem: '2.16.840.1.113883.6.1',
codeSystemName: 'LOINC',
displayName: 'Progress Note'
}
}
],
directives: {
newPatient: false,
useCase: 'HIGH_RISK',
diagnosticCategories: {
autoimmune: false,
bariatric: false,
behavioral: false,
cardiovascular: false,
dental: false,
dermatological: false,
endocrinological: false,
gastroenterological: false,
generalInformation: false,
generalSurgery: false,
hematological: false,
infectious: false,
lymphatic: false,
mens: false,
metabolic: false,
musculoskeletal: false,
neonatological: false,
neurological: false,
nutritional: false,
oncological: false,
ophthalmic: false,
otolaryngological: false,
pain: false,
postSurgery: false,
pulmonary: false,
renal: false,
spinal: false,
stroke: false,
toxicological: false,
urological: false,
womens: false
},
medicationsOfInterest: [
{
active: true,
nameCode: {
code: '6809',
codeSystem: '2.16.840.1.113883.6.88',
codeSystemName: 'RxNorm',
displayName: 'metFORMIN'
},
classCode: {
code: 'N0000175565',
codeSystem: '2.16.840.1.113883.6.345',
codeSystemName: 'MED-RT',
displayName: 'Biguanide'
},
scheduleCode: {
code: 'IV',
codeSystem: '2.16.840.1.113883.12.477',
codeSystemName: 'Controlled Substance Schedule',
displayName: 'Schedule IV'
},
medicationRequests: [
{
code: {
code: '861007',
codeSystem: '2.16.840.1.113883.6.88',
codeSystemName: 'RxNorm',
displayName: 'metFORMIN hydrochloride 500 MG Oral Tablet'
},
form: {
code: 'C42998',
codeSystem: '2.16.840.1.113883.3.26.1.1',
codeSystemName: 'NCI Thesaurus',
displayName: 'tablet'
},
route: {
code: 'C38288',
codeSystem: '2.16.840.1.113883.3.26.1.1',
codeSystemName: 'NCI Thesaurus',
displayName: 'oral'
},
prescribedDate: '2023-12-02',
initialFillQuantity: 10,
numberOfRefillsAllowed: 0,
timingEvent: 'QD',
frequencyUnit: 'd',
frequencyValue: 1,
dosageInstruction: {
text: 'take 1 tablet by mouth once daily',
strengthUnit: 'mg',
strengthValue: 100,
amountUnit: 'puffs',
amountValue: 2
}
}
]
}
],
riskAdjustmentConfiguration: {},
careManagementConfiguration: {},
qualityMeasureConfiguration: {asOfDateOverride: '2025-12-31'}
}
}
],
batchId: 'BATCH-123',
patientPanelDirectives: {
requestMedicationHistory: true,
deliverableDocuments: ['PATIENT_CARE_SUMMARY', 'QUALITY_MEASURES_SUMMARY'],
principalOid: '<string>'
}
})
};
fetch('https://processing-request-staging.connectivehealth.io/v2/patient-data/validate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://processing-request-staging.connectivehealth.io/v2/patient-data/validate",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'patientProcessingRequests' => [
[
'patient' => [
'mrn' => [
'root' => '1.2.3.4',
'extension' => 'ABC123'
],
'name' => [
'family' => 'Johnson',
'given' => [
'John',
'Aaron'
],
'prefix' => 'Mr.',
'suffix' => 'Jr.'
],
'birthDate' => '1992-04-09',
'addresses' => [
[
'lines' => [
'123 Main St',
'Suite 517'
],
'city' => 'Minneapolis',
'state' => 'MN',
'zip' => '55401'
]
],
'contactPoints' => [
[
'value' => '9525551234',
'contactPointSystem' => 'PHONE',
'contactPointUse' => 'HOME'
]
]
],
'requestingProvider' => [
'npi' => '1414912117',
'name' => [
'family' => 'Johnson',
'given' => [
'John',
'Aaron'
],
'prefix' => 'Mr.',
'suffix' => 'Jr.'
]
],
'upcomingAppointmentDate' => '2025-11-05',
'enrollmentDate' => '2025-11-05',
'clinicName' => 'Simple Clinic Name',
'clinicNpi' => '1414912117',
'responseDirectAddress' => 'contact@yourdomain.com',
'responseFriendlyName' => 'Heart Clinic',
'diagnoses' => [
[
'code' => 'E66.01',
'codeSystem' => '2.16.840.1.113883.6.90',
'displayName' => 'Morbid (severe) obesity due to excess calories',
'active' => true,
'date' => '2022-12-12'
]
],
'procedures' => [
[
'date' => '2022-12-12',
'code' => [
'code' => '44970',
'codeSystem' => '2.16.840.1.113883.6.12',
'codeSystemName' => 'CPT',
'displayName' => 'Laparoscopy, surgical, appendectomy'
],
'targetSite' => [
'code' => '66754008',
'codeSystem' => '2.16.840.1.113883.6.96',
'codeSystemName' => 'SNOMED CT',
'displayName' => 'Appendix structure'
],
'note' => 'Procedure was well tolerated'
]
],
'immunizations' => [
[
'date' => '2024-10-01',
'code' => [
'code' => '150',
'codeSystem' => '2.16.840.1.113883.12.292',
'codeSystemName' => 'CVX',
'displayName' => 'Influenza, injectable, quadrivalent, preservative free'
]
]
],
'medications' => [
[
'active' => true,
'nameCode' => [
'code' => '6809',
'codeSystem' => '2.16.840.1.113883.6.88',
'codeSystemName' => 'RxNorm',
'displayName' => 'metFORMIN'
],
'classCode' => [
'code' => 'N0000175565',
'codeSystem' => '2.16.840.1.113883.6.345',
'codeSystemName' => 'MED-RT',
'displayName' => 'Biguanide'
],
'scheduleCode' => [
'code' => 'IV',
'codeSystem' => '2.16.840.1.113883.12.477',
'codeSystemName' => 'Controlled Substance Schedule',
'displayName' => 'Schedule IV'
],
'medicationRequests' => [
[
'code' => [
'code' => '861007',
'codeSystem' => '2.16.840.1.113883.6.88',
'codeSystemName' => 'RxNorm',
'displayName' => 'metFORMIN hydrochloride 500 MG Oral Tablet'
],
'form' => [
'code' => 'C42998',
'codeSystem' => '2.16.840.1.113883.3.26.1.1',
'codeSystemName' => 'NCI Thesaurus',
'displayName' => 'tablet'
],
'route' => [
'code' => 'C38288',
'codeSystem' => '2.16.840.1.113883.3.26.1.1',
'codeSystemName' => 'NCI Thesaurus',
'displayName' => 'oral'
],
'prescribedDate' => '2023-12-02',
'initialFillQuantity' => 10,
'numberOfRefillsAllowed' => 0,
'timingEvent' => 'QD',
'frequencyUnit' => 'd',
'frequencyValue' => 1,
'dosageInstruction' => [
'text' => 'take 1 tablet by mouth once daily',
'strengthUnit' => 'mg',
'strengthValue' => 100,
'amountUnit' => 'puffs',
'amountValue' => 2
]
]
]
]
],
'clinicalNotes' => [
[
'lines' => [
'The patient was pleasant',
'Recommend following up in 2 weeks'
],
'date' => '2022-12-12',
'code' => [
'code' => '11506-3',
'codeSystem' => '2.16.840.1.113883.6.1',
'codeSystemName' => 'LOINC',
'displayName' => 'Progress Note'
]
]
],
'directives' => [
'newPatient' => false,
'useCase' => 'HIGH_RISK',
'diagnosticCategories' => [
'autoimmune' => false,
'bariatric' => false,
'behavioral' => false,
'cardiovascular' => false,
'dental' => false,
'dermatological' => false,
'endocrinological' => false,
'gastroenterological' => false,
'generalInformation' => false,
'generalSurgery' => false,
'hematological' => false,
'infectious' => false,
'lymphatic' => false,
'mens' => false,
'metabolic' => false,
'musculoskeletal' => false,
'neonatological' => false,
'neurological' => false,
'nutritional' => false,
'oncological' => false,
'ophthalmic' => false,
'otolaryngological' => false,
'pain' => false,
'postSurgery' => false,
'pulmonary' => false,
'renal' => false,
'spinal' => false,
'stroke' => false,
'toxicological' => false,
'urological' => false,
'womens' => false
],
'medicationsOfInterest' => [
[
'active' => true,
'nameCode' => [
'code' => '6809',
'codeSystem' => '2.16.840.1.113883.6.88',
'codeSystemName' => 'RxNorm',
'displayName' => 'metFORMIN'
],
'classCode' => [
'code' => 'N0000175565',
'codeSystem' => '2.16.840.1.113883.6.345',
'codeSystemName' => 'MED-RT',
'displayName' => 'Biguanide'
],
'scheduleCode' => [
'code' => 'IV',
'codeSystem' => '2.16.840.1.113883.12.477',
'codeSystemName' => 'Controlled Substance Schedule',
'displayName' => 'Schedule IV'
],
'medicationRequests' => [
[
'code' => [
'code' => '861007',
'codeSystem' => '2.16.840.1.113883.6.88',
'codeSystemName' => 'RxNorm',
'displayName' => 'metFORMIN hydrochloride 500 MG Oral Tablet'
],
'form' => [
'code' => 'C42998',
'codeSystem' => '2.16.840.1.113883.3.26.1.1',
'codeSystemName' => 'NCI Thesaurus',
'displayName' => 'tablet'
],
'route' => [
'code' => 'C38288',
'codeSystem' => '2.16.840.1.113883.3.26.1.1',
'codeSystemName' => 'NCI Thesaurus',
'displayName' => 'oral'
],
'prescribedDate' => '2023-12-02',
'initialFillQuantity' => 10,
'numberOfRefillsAllowed' => 0,
'timingEvent' => 'QD',
'frequencyUnit' => 'd',
'frequencyValue' => 1,
'dosageInstruction' => [
'text' => 'take 1 tablet by mouth once daily',
'strengthUnit' => 'mg',
'strengthValue' => 100,
'amountUnit' => 'puffs',
'amountValue' => 2
]
]
]
]
],
'riskAdjustmentConfiguration' => [
],
'careManagementConfiguration' => [
],
'qualityMeasureConfiguration' => [
'asOfDateOverride' => '2025-12-31'
]
]
]
],
'batchId' => 'BATCH-123',
'patientPanelDirectives' => [
'requestMedicationHistory' => true,
'deliverableDocuments' => [
'PATIENT_CARE_SUMMARY',
'QUALITY_MEASURES_SUMMARY'
],
'principalOid' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"apiKey: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://processing-request-staging.connectivehealth.io/v2/patient-data/validate"
payload := strings.NewReader("{\n \"patientProcessingRequests\": [\n {\n \"patient\": {\n \"mrn\": {\n \"root\": \"1.2.3.4\",\n \"extension\": \"ABC123\"\n },\n \"name\": {\n \"family\": \"Johnson\",\n \"given\": [\n \"John\",\n \"Aaron\"\n ],\n \"prefix\": \"Mr.\",\n \"suffix\": \"Jr.\"\n },\n \"birthDate\": \"1992-04-09\",\n \"addresses\": [\n {\n \"lines\": [\n \"123 Main St\",\n \"Suite 517\"\n ],\n \"city\": \"Minneapolis\",\n \"state\": \"MN\",\n \"zip\": \"55401\"\n }\n ],\n \"contactPoints\": [\n {\n \"value\": \"9525551234\",\n \"contactPointSystem\": \"PHONE\",\n \"contactPointUse\": \"HOME\"\n }\n ]\n },\n \"requestingProvider\": {\n \"npi\": \"1414912117\",\n \"name\": {\n \"family\": \"Johnson\",\n \"given\": [\n \"John\",\n \"Aaron\"\n ],\n \"prefix\": \"Mr.\",\n \"suffix\": \"Jr.\"\n }\n },\n \"upcomingAppointmentDate\": \"2025-11-05\",\n \"enrollmentDate\": \"2025-11-05\",\n \"clinicName\": \"Simple Clinic Name\",\n \"clinicNpi\": \"1414912117\",\n \"responseDirectAddress\": \"contact@yourdomain.com\",\n \"responseFriendlyName\": \"Heart Clinic\",\n \"diagnoses\": [\n {\n \"code\": \"E66.01\",\n \"codeSystem\": \"2.16.840.1.113883.6.90\",\n \"displayName\": \"Morbid (severe) obesity due to excess calories\",\n \"active\": true,\n \"date\": \"2022-12-12\"\n }\n ],\n \"procedures\": [\n {\n \"date\": \"2022-12-12\",\n \"code\": {\n \"code\": \"44970\",\n \"codeSystem\": \"2.16.840.1.113883.6.12\",\n \"codeSystemName\": \"CPT\",\n \"displayName\": \"Laparoscopy, surgical, appendectomy\"\n },\n \"targetSite\": {\n \"code\": \"66754008\",\n \"codeSystem\": \"2.16.840.1.113883.6.96\",\n \"codeSystemName\": \"SNOMED CT\",\n \"displayName\": \"Appendix structure\"\n },\n \"note\": \"Procedure was well tolerated\"\n }\n ],\n \"immunizations\": [\n {\n \"date\": \"2024-10-01\",\n \"code\": {\n \"code\": \"150\",\n \"codeSystem\": \"2.16.840.1.113883.12.292\",\n \"codeSystemName\": \"CVX\",\n \"displayName\": \"Influenza, injectable, quadrivalent, preservative free\"\n }\n }\n ],\n \"medications\": [\n {\n \"active\": true,\n \"nameCode\": {\n \"code\": \"6809\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN\"\n },\n \"classCode\": {\n \"code\": \"N0000175565\",\n \"codeSystem\": \"2.16.840.1.113883.6.345\",\n \"codeSystemName\": \"MED-RT\",\n \"displayName\": \"Biguanide\"\n },\n \"scheduleCode\": {\n \"code\": \"IV\",\n \"codeSystem\": \"2.16.840.1.113883.12.477\",\n \"codeSystemName\": \"Controlled Substance Schedule\",\n \"displayName\": \"Schedule IV\"\n },\n \"medicationRequests\": [\n {\n \"code\": {\n \"code\": \"861007\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN hydrochloride 500 MG Oral Tablet\"\n },\n \"form\": {\n \"code\": \"C42998\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"tablet\"\n },\n \"route\": {\n \"code\": \"C38288\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"oral\"\n },\n \"prescribedDate\": \"2023-12-02\",\n \"initialFillQuantity\": 10,\n \"numberOfRefillsAllowed\": 0,\n \"timingEvent\": \"QD\",\n \"frequencyUnit\": \"d\",\n \"frequencyValue\": 1,\n \"dosageInstruction\": {\n \"text\": \"take 1 tablet by mouth once daily\",\n \"strengthUnit\": \"mg\",\n \"strengthValue\": 100,\n \"amountUnit\": \"puffs\",\n \"amountValue\": 2\n }\n }\n ]\n }\n ],\n \"clinicalNotes\": [\n {\n \"lines\": [\n \"The patient was pleasant\",\n \"Recommend following up in 2 weeks\"\n ],\n \"date\": \"2022-12-12\",\n \"code\": {\n \"code\": \"11506-3\",\n \"codeSystem\": \"2.16.840.1.113883.6.1\",\n \"codeSystemName\": \"LOINC\",\n \"displayName\": \"Progress Note\"\n }\n }\n ],\n \"directives\": {\n \"newPatient\": false,\n \"useCase\": \"HIGH_RISK\",\n \"diagnosticCategories\": {\n \"autoimmune\": false,\n \"bariatric\": false,\n \"behavioral\": false,\n \"cardiovascular\": false,\n \"dental\": false,\n \"dermatological\": false,\n \"endocrinological\": false,\n \"gastroenterological\": false,\n \"generalInformation\": false,\n \"generalSurgery\": false,\n \"hematological\": false,\n \"infectious\": false,\n \"lymphatic\": false,\n \"mens\": false,\n \"metabolic\": false,\n \"musculoskeletal\": false,\n \"neonatological\": false,\n \"neurological\": false,\n \"nutritional\": false,\n \"oncological\": false,\n \"ophthalmic\": false,\n \"otolaryngological\": false,\n \"pain\": false,\n \"postSurgery\": false,\n \"pulmonary\": false,\n \"renal\": false,\n \"spinal\": false,\n \"stroke\": false,\n \"toxicological\": false,\n \"urological\": false,\n \"womens\": false\n },\n \"medicationsOfInterest\": [\n {\n \"active\": true,\n \"nameCode\": {\n \"code\": \"6809\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN\"\n },\n \"classCode\": {\n \"code\": \"N0000175565\",\n \"codeSystem\": \"2.16.840.1.113883.6.345\",\n \"codeSystemName\": \"MED-RT\",\n \"displayName\": \"Biguanide\"\n },\n \"scheduleCode\": {\n \"code\": \"IV\",\n \"codeSystem\": \"2.16.840.1.113883.12.477\",\n \"codeSystemName\": \"Controlled Substance Schedule\",\n \"displayName\": \"Schedule IV\"\n },\n \"medicationRequests\": [\n {\n \"code\": {\n \"code\": \"861007\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN hydrochloride 500 MG Oral Tablet\"\n },\n \"form\": {\n \"code\": \"C42998\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"tablet\"\n },\n \"route\": {\n \"code\": \"C38288\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"oral\"\n },\n \"prescribedDate\": \"2023-12-02\",\n \"initialFillQuantity\": 10,\n \"numberOfRefillsAllowed\": 0,\n \"timingEvent\": \"QD\",\n \"frequencyUnit\": \"d\",\n \"frequencyValue\": 1,\n \"dosageInstruction\": {\n \"text\": \"take 1 tablet by mouth once daily\",\n \"strengthUnit\": \"mg\",\n \"strengthValue\": 100,\n \"amountUnit\": \"puffs\",\n \"amountValue\": 2\n }\n }\n ]\n }\n ],\n \"riskAdjustmentConfiguration\": {},\n \"careManagementConfiguration\": {},\n \"qualityMeasureConfiguration\": {\n \"asOfDateOverride\": \"2025-12-31\"\n }\n }\n }\n ],\n \"batchId\": \"BATCH-123\",\n \"patientPanelDirectives\": {\n \"requestMedicationHistory\": true,\n \"deliverableDocuments\": [\n \"PATIENT_CARE_SUMMARY\",\n \"QUALITY_MEASURES_SUMMARY\"\n ],\n \"principalOid\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("apiKey", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://processing-request-staging.connectivehealth.io/v2/patient-data/validate")
.header("apiKey", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"patientProcessingRequests\": [\n {\n \"patient\": {\n \"mrn\": {\n \"root\": \"1.2.3.4\",\n \"extension\": \"ABC123\"\n },\n \"name\": {\n \"family\": \"Johnson\",\n \"given\": [\n \"John\",\n \"Aaron\"\n ],\n \"prefix\": \"Mr.\",\n \"suffix\": \"Jr.\"\n },\n \"birthDate\": \"1992-04-09\",\n \"addresses\": [\n {\n \"lines\": [\n \"123 Main St\",\n \"Suite 517\"\n ],\n \"city\": \"Minneapolis\",\n \"state\": \"MN\",\n \"zip\": \"55401\"\n }\n ],\n \"contactPoints\": [\n {\n \"value\": \"9525551234\",\n \"contactPointSystem\": \"PHONE\",\n \"contactPointUse\": \"HOME\"\n }\n ]\n },\n \"requestingProvider\": {\n \"npi\": \"1414912117\",\n \"name\": {\n \"family\": \"Johnson\",\n \"given\": [\n \"John\",\n \"Aaron\"\n ],\n \"prefix\": \"Mr.\",\n \"suffix\": \"Jr.\"\n }\n },\n \"upcomingAppointmentDate\": \"2025-11-05\",\n \"enrollmentDate\": \"2025-11-05\",\n \"clinicName\": \"Simple Clinic Name\",\n \"clinicNpi\": \"1414912117\",\n \"responseDirectAddress\": \"contact@yourdomain.com\",\n \"responseFriendlyName\": \"Heart Clinic\",\n \"diagnoses\": [\n {\n \"code\": \"E66.01\",\n \"codeSystem\": \"2.16.840.1.113883.6.90\",\n \"displayName\": \"Morbid (severe) obesity due to excess calories\",\n \"active\": true,\n \"date\": \"2022-12-12\"\n }\n ],\n \"procedures\": [\n {\n \"date\": \"2022-12-12\",\n \"code\": {\n \"code\": \"44970\",\n \"codeSystem\": \"2.16.840.1.113883.6.12\",\n \"codeSystemName\": \"CPT\",\n \"displayName\": \"Laparoscopy, surgical, appendectomy\"\n },\n \"targetSite\": {\n \"code\": \"66754008\",\n \"codeSystem\": \"2.16.840.1.113883.6.96\",\n \"codeSystemName\": \"SNOMED CT\",\n \"displayName\": \"Appendix structure\"\n },\n \"note\": \"Procedure was well tolerated\"\n }\n ],\n \"immunizations\": [\n {\n \"date\": \"2024-10-01\",\n \"code\": {\n \"code\": \"150\",\n \"codeSystem\": \"2.16.840.1.113883.12.292\",\n \"codeSystemName\": \"CVX\",\n \"displayName\": \"Influenza, injectable, quadrivalent, preservative free\"\n }\n }\n ],\n \"medications\": [\n {\n \"active\": true,\n \"nameCode\": {\n \"code\": \"6809\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN\"\n },\n \"classCode\": {\n \"code\": \"N0000175565\",\n \"codeSystem\": \"2.16.840.1.113883.6.345\",\n \"codeSystemName\": \"MED-RT\",\n \"displayName\": \"Biguanide\"\n },\n \"scheduleCode\": {\n \"code\": \"IV\",\n \"codeSystem\": \"2.16.840.1.113883.12.477\",\n \"codeSystemName\": \"Controlled Substance Schedule\",\n \"displayName\": \"Schedule IV\"\n },\n \"medicationRequests\": [\n {\n \"code\": {\n \"code\": \"861007\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN hydrochloride 500 MG Oral Tablet\"\n },\n \"form\": {\n \"code\": \"C42998\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"tablet\"\n },\n \"route\": {\n \"code\": \"C38288\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"oral\"\n },\n \"prescribedDate\": \"2023-12-02\",\n \"initialFillQuantity\": 10,\n \"numberOfRefillsAllowed\": 0,\n \"timingEvent\": \"QD\",\n \"frequencyUnit\": \"d\",\n \"frequencyValue\": 1,\n \"dosageInstruction\": {\n \"text\": \"take 1 tablet by mouth once daily\",\n \"strengthUnit\": \"mg\",\n \"strengthValue\": 100,\n \"amountUnit\": \"puffs\",\n \"amountValue\": 2\n }\n }\n ]\n }\n ],\n \"clinicalNotes\": [\n {\n \"lines\": [\n \"The patient was pleasant\",\n \"Recommend following up in 2 weeks\"\n ],\n \"date\": \"2022-12-12\",\n \"code\": {\n \"code\": \"11506-3\",\n \"codeSystem\": \"2.16.840.1.113883.6.1\",\n \"codeSystemName\": \"LOINC\",\n \"displayName\": \"Progress Note\"\n }\n }\n ],\n \"directives\": {\n \"newPatient\": false,\n \"useCase\": \"HIGH_RISK\",\n \"diagnosticCategories\": {\n \"autoimmune\": false,\n \"bariatric\": false,\n \"behavioral\": false,\n \"cardiovascular\": false,\n \"dental\": false,\n \"dermatological\": false,\n \"endocrinological\": false,\n \"gastroenterological\": false,\n \"generalInformation\": false,\n \"generalSurgery\": false,\n \"hematological\": false,\n \"infectious\": false,\n \"lymphatic\": false,\n \"mens\": false,\n \"metabolic\": false,\n \"musculoskeletal\": false,\n \"neonatological\": false,\n \"neurological\": false,\n \"nutritional\": false,\n \"oncological\": false,\n \"ophthalmic\": false,\n \"otolaryngological\": false,\n \"pain\": false,\n \"postSurgery\": false,\n \"pulmonary\": false,\n \"renal\": false,\n \"spinal\": false,\n \"stroke\": false,\n \"toxicological\": false,\n \"urological\": false,\n \"womens\": false\n },\n \"medicationsOfInterest\": [\n {\n \"active\": true,\n \"nameCode\": {\n \"code\": \"6809\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN\"\n },\n \"classCode\": {\n \"code\": \"N0000175565\",\n \"codeSystem\": \"2.16.840.1.113883.6.345\",\n \"codeSystemName\": \"MED-RT\",\n \"displayName\": \"Biguanide\"\n },\n \"scheduleCode\": {\n \"code\": \"IV\",\n \"codeSystem\": \"2.16.840.1.113883.12.477\",\n \"codeSystemName\": \"Controlled Substance Schedule\",\n \"displayName\": \"Schedule IV\"\n },\n \"medicationRequests\": [\n {\n \"code\": {\n \"code\": \"861007\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN hydrochloride 500 MG Oral Tablet\"\n },\n \"form\": {\n \"code\": \"C42998\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"tablet\"\n },\n \"route\": {\n \"code\": \"C38288\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"oral\"\n },\n \"prescribedDate\": \"2023-12-02\",\n \"initialFillQuantity\": 10,\n \"numberOfRefillsAllowed\": 0,\n \"timingEvent\": \"QD\",\n \"frequencyUnit\": \"d\",\n \"frequencyValue\": 1,\n \"dosageInstruction\": {\n \"text\": \"take 1 tablet by mouth once daily\",\n \"strengthUnit\": \"mg\",\n \"strengthValue\": 100,\n \"amountUnit\": \"puffs\",\n \"amountValue\": 2\n }\n }\n ]\n }\n ],\n \"riskAdjustmentConfiguration\": {},\n \"careManagementConfiguration\": {},\n \"qualityMeasureConfiguration\": {\n \"asOfDateOverride\": \"2025-12-31\"\n }\n }\n }\n ],\n \"batchId\": \"BATCH-123\",\n \"patientPanelDirectives\": {\n \"requestMedicationHistory\": true,\n \"deliverableDocuments\": [\n \"PATIENT_CARE_SUMMARY\",\n \"QUALITY_MEASURES_SUMMARY\"\n ],\n \"principalOid\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://processing-request-staging.connectivehealth.io/v2/patient-data/validate")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["apiKey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"patientProcessingRequests\": [\n {\n \"patient\": {\n \"mrn\": {\n \"root\": \"1.2.3.4\",\n \"extension\": \"ABC123\"\n },\n \"name\": {\n \"family\": \"Johnson\",\n \"given\": [\n \"John\",\n \"Aaron\"\n ],\n \"prefix\": \"Mr.\",\n \"suffix\": \"Jr.\"\n },\n \"birthDate\": \"1992-04-09\",\n \"addresses\": [\n {\n \"lines\": [\n \"123 Main St\",\n \"Suite 517\"\n ],\n \"city\": \"Minneapolis\",\n \"state\": \"MN\",\n \"zip\": \"55401\"\n }\n ],\n \"contactPoints\": [\n {\n \"value\": \"9525551234\",\n \"contactPointSystem\": \"PHONE\",\n \"contactPointUse\": \"HOME\"\n }\n ]\n },\n \"requestingProvider\": {\n \"npi\": \"1414912117\",\n \"name\": {\n \"family\": \"Johnson\",\n \"given\": [\n \"John\",\n \"Aaron\"\n ],\n \"prefix\": \"Mr.\",\n \"suffix\": \"Jr.\"\n }\n },\n \"upcomingAppointmentDate\": \"2025-11-05\",\n \"enrollmentDate\": \"2025-11-05\",\n \"clinicName\": \"Simple Clinic Name\",\n \"clinicNpi\": \"1414912117\",\n \"responseDirectAddress\": \"contact@yourdomain.com\",\n \"responseFriendlyName\": \"Heart Clinic\",\n \"diagnoses\": [\n {\n \"code\": \"E66.01\",\n \"codeSystem\": \"2.16.840.1.113883.6.90\",\n \"displayName\": \"Morbid (severe) obesity due to excess calories\",\n \"active\": true,\n \"date\": \"2022-12-12\"\n }\n ],\n \"procedures\": [\n {\n \"date\": \"2022-12-12\",\n \"code\": {\n \"code\": \"44970\",\n \"codeSystem\": \"2.16.840.1.113883.6.12\",\n \"codeSystemName\": \"CPT\",\n \"displayName\": \"Laparoscopy, surgical, appendectomy\"\n },\n \"targetSite\": {\n \"code\": \"66754008\",\n \"codeSystem\": \"2.16.840.1.113883.6.96\",\n \"codeSystemName\": \"SNOMED CT\",\n \"displayName\": \"Appendix structure\"\n },\n \"note\": \"Procedure was well tolerated\"\n }\n ],\n \"immunizations\": [\n {\n \"date\": \"2024-10-01\",\n \"code\": {\n \"code\": \"150\",\n \"codeSystem\": \"2.16.840.1.113883.12.292\",\n \"codeSystemName\": \"CVX\",\n \"displayName\": \"Influenza, injectable, quadrivalent, preservative free\"\n }\n }\n ],\n \"medications\": [\n {\n \"active\": true,\n \"nameCode\": {\n \"code\": \"6809\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN\"\n },\n \"classCode\": {\n \"code\": \"N0000175565\",\n \"codeSystem\": \"2.16.840.1.113883.6.345\",\n \"codeSystemName\": \"MED-RT\",\n \"displayName\": \"Biguanide\"\n },\n \"scheduleCode\": {\n \"code\": \"IV\",\n \"codeSystem\": \"2.16.840.1.113883.12.477\",\n \"codeSystemName\": \"Controlled Substance Schedule\",\n \"displayName\": \"Schedule IV\"\n },\n \"medicationRequests\": [\n {\n \"code\": {\n \"code\": \"861007\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN hydrochloride 500 MG Oral Tablet\"\n },\n \"form\": {\n \"code\": \"C42998\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"tablet\"\n },\n \"route\": {\n \"code\": \"C38288\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"oral\"\n },\n \"prescribedDate\": \"2023-12-02\",\n \"initialFillQuantity\": 10,\n \"numberOfRefillsAllowed\": 0,\n \"timingEvent\": \"QD\",\n \"frequencyUnit\": \"d\",\n \"frequencyValue\": 1,\n \"dosageInstruction\": {\n \"text\": \"take 1 tablet by mouth once daily\",\n \"strengthUnit\": \"mg\",\n \"strengthValue\": 100,\n \"amountUnit\": \"puffs\",\n \"amountValue\": 2\n }\n }\n ]\n }\n ],\n \"clinicalNotes\": [\n {\n \"lines\": [\n \"The patient was pleasant\",\n \"Recommend following up in 2 weeks\"\n ],\n \"date\": \"2022-12-12\",\n \"code\": {\n \"code\": \"11506-3\",\n \"codeSystem\": \"2.16.840.1.113883.6.1\",\n \"codeSystemName\": \"LOINC\",\n \"displayName\": \"Progress Note\"\n }\n }\n ],\n \"directives\": {\n \"newPatient\": false,\n \"useCase\": \"HIGH_RISK\",\n \"diagnosticCategories\": {\n \"autoimmune\": false,\n \"bariatric\": false,\n \"behavioral\": false,\n \"cardiovascular\": false,\n \"dental\": false,\n \"dermatological\": false,\n \"endocrinological\": false,\n \"gastroenterological\": false,\n \"generalInformation\": false,\n \"generalSurgery\": false,\n \"hematological\": false,\n \"infectious\": false,\n \"lymphatic\": false,\n \"mens\": false,\n \"metabolic\": false,\n \"musculoskeletal\": false,\n \"neonatological\": false,\n \"neurological\": false,\n \"nutritional\": false,\n \"oncological\": false,\n \"ophthalmic\": false,\n \"otolaryngological\": false,\n \"pain\": false,\n \"postSurgery\": false,\n \"pulmonary\": false,\n \"renal\": false,\n \"spinal\": false,\n \"stroke\": false,\n \"toxicological\": false,\n \"urological\": false,\n \"womens\": false\n },\n \"medicationsOfInterest\": [\n {\n \"active\": true,\n \"nameCode\": {\n \"code\": \"6809\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN\"\n },\n \"classCode\": {\n \"code\": \"N0000175565\",\n \"codeSystem\": \"2.16.840.1.113883.6.345\",\n \"codeSystemName\": \"MED-RT\",\n \"displayName\": \"Biguanide\"\n },\n \"scheduleCode\": {\n \"code\": \"IV\",\n \"codeSystem\": \"2.16.840.1.113883.12.477\",\n \"codeSystemName\": \"Controlled Substance Schedule\",\n \"displayName\": \"Schedule IV\"\n },\n \"medicationRequests\": [\n {\n \"code\": {\n \"code\": \"861007\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN hydrochloride 500 MG Oral Tablet\"\n },\n \"form\": {\n \"code\": \"C42998\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"tablet\"\n },\n \"route\": {\n \"code\": \"C38288\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"oral\"\n },\n \"prescribedDate\": \"2023-12-02\",\n \"initialFillQuantity\": 10,\n \"numberOfRefillsAllowed\": 0,\n \"timingEvent\": \"QD\",\n \"frequencyUnit\": \"d\",\n \"frequencyValue\": 1,\n \"dosageInstruction\": {\n \"text\": \"take 1 tablet by mouth once daily\",\n \"strengthUnit\": \"mg\",\n \"strengthValue\": 100,\n \"amountUnit\": \"puffs\",\n \"amountValue\": 2\n }\n }\n ]\n }\n ],\n \"riskAdjustmentConfiguration\": {},\n \"careManagementConfiguration\": {},\n \"qualityMeasureConfiguration\": {\n \"asOfDateOverride\": \"2025-12-31\"\n }\n }\n }\n ],\n \"batchId\": \"BATCH-123\",\n \"patientPanelDirectives\": {\n \"requestMedicationHistory\": true,\n \"deliverableDocuments\": [\n \"PATIENT_CARE_SUMMARY\",\n \"QUALITY_MEASURES_SUMMARY\"\n ],\n \"principalOid\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"correlationId": "10c7b080-76f2-4aff-beeb-a2f7b4ca7a89",
"responses": [
{
"sequenceNumber": 0,
"correlationId": "4b0b3bdc-d007-4274-b1c7-f89fbb2fd775"
},
{
"sequenceNumber": 1,
"correlationId": "e82a9cfb-a6cd-4194-a0fd-9882b3a4e76b"
},
{
"sequenceNumber": 2,
"correlationId": "e5c3310a-6cb4-4755-a5c2-35b99d946181"
}
]
}{
"message": "<string>",
"_links": {},
"_embedded": {},
"logref": "<unknown>",
"path": "<unknown>"
}{
"correlationId": "10c7b080-76f2-4aff-beeb-a2f7b4ca7a89",
"responses": [
{
"sequenceNumber": 0,
"correlationId": "4b0b3bdc-d007-4274-b1c7-f89fbb2fd775"
},
{
"sequenceNumber": 1,
"correlationId": "e82a9cfb-a6cd-4194-a0fd-9882b3a4e76b"
},
{
"sequenceNumber": 2,
"correlationId": "e5c3310a-6cb4-4755-a5c2-35b99d946181"
}
]
}Clinical Data
Patient Data v2 Validate
Validates the request without doing any processing
POST
/
v2
/
patient-data
/
validate
Validate Patient Processing Panel
curl --request POST \
--url https://processing-request-staging.connectivehealth.io/v2/patient-data/validate \
--header 'Content-Type: application/json' \
--header 'apiKey: <api-key>' \
--data '
{
"patientProcessingRequests": [
{
"patient": {
"mrn": {
"root": "1.2.3.4",
"extension": "ABC123"
},
"name": {
"family": "Johnson",
"given": [
"John",
"Aaron"
],
"prefix": "Mr.",
"suffix": "Jr."
},
"birthDate": "1992-04-09",
"addresses": [
{
"lines": [
"123 Main St",
"Suite 517"
],
"city": "Minneapolis",
"state": "MN",
"zip": "55401"
}
],
"contactPoints": [
{
"value": "9525551234",
"contactPointSystem": "PHONE",
"contactPointUse": "HOME"
}
]
},
"requestingProvider": {
"npi": "1414912117",
"name": {
"family": "Johnson",
"given": [
"John",
"Aaron"
],
"prefix": "Mr.",
"suffix": "Jr."
}
},
"upcomingAppointmentDate": "2025-11-05",
"enrollmentDate": "2025-11-05",
"clinicName": "Simple Clinic Name",
"clinicNpi": "1414912117",
"responseDirectAddress": "contact@yourdomain.com",
"responseFriendlyName": "Heart Clinic",
"diagnoses": [
{
"code": "E66.01",
"codeSystem": "2.16.840.1.113883.6.90",
"displayName": "Morbid (severe) obesity due to excess calories",
"active": true,
"date": "2022-12-12"
}
],
"procedures": [
{
"date": "2022-12-12",
"code": {
"code": "44970",
"codeSystem": "2.16.840.1.113883.6.12",
"codeSystemName": "CPT",
"displayName": "Laparoscopy, surgical, appendectomy"
},
"targetSite": {
"code": "66754008",
"codeSystem": "2.16.840.1.113883.6.96",
"codeSystemName": "SNOMED CT",
"displayName": "Appendix structure"
},
"note": "Procedure was well tolerated"
}
],
"immunizations": [
{
"date": "2024-10-01",
"code": {
"code": "150",
"codeSystem": "2.16.840.1.113883.12.292",
"codeSystemName": "CVX",
"displayName": "Influenza, injectable, quadrivalent, preservative free"
}
}
],
"medications": [
{
"active": true,
"nameCode": {
"code": "6809",
"codeSystem": "2.16.840.1.113883.6.88",
"codeSystemName": "RxNorm",
"displayName": "metFORMIN"
},
"classCode": {
"code": "N0000175565",
"codeSystem": "2.16.840.1.113883.6.345",
"codeSystemName": "MED-RT",
"displayName": "Biguanide"
},
"scheduleCode": {
"code": "IV",
"codeSystem": "2.16.840.1.113883.12.477",
"codeSystemName": "Controlled Substance Schedule",
"displayName": "Schedule IV"
},
"medicationRequests": [
{
"code": {
"code": "861007",
"codeSystem": "2.16.840.1.113883.6.88",
"codeSystemName": "RxNorm",
"displayName": "metFORMIN hydrochloride 500 MG Oral Tablet"
},
"form": {
"code": "C42998",
"codeSystem": "2.16.840.1.113883.3.26.1.1",
"codeSystemName": "NCI Thesaurus",
"displayName": "tablet"
},
"route": {
"code": "C38288",
"codeSystem": "2.16.840.1.113883.3.26.1.1",
"codeSystemName": "NCI Thesaurus",
"displayName": "oral"
},
"prescribedDate": "2023-12-02",
"initialFillQuantity": 10,
"numberOfRefillsAllowed": 0,
"timingEvent": "QD",
"frequencyUnit": "d",
"frequencyValue": 1,
"dosageInstruction": {
"text": "take 1 tablet by mouth once daily",
"strengthUnit": "mg",
"strengthValue": 100,
"amountUnit": "puffs",
"amountValue": 2
}
}
]
}
],
"clinicalNotes": [
{
"lines": [
"The patient was pleasant",
"Recommend following up in 2 weeks"
],
"date": "2022-12-12",
"code": {
"code": "11506-3",
"codeSystem": "2.16.840.1.113883.6.1",
"codeSystemName": "LOINC",
"displayName": "Progress Note"
}
}
],
"directives": {
"newPatient": false,
"useCase": "HIGH_RISK",
"diagnosticCategories": {
"autoimmune": false,
"bariatric": false,
"behavioral": false,
"cardiovascular": false,
"dental": false,
"dermatological": false,
"endocrinological": false,
"gastroenterological": false,
"generalInformation": false,
"generalSurgery": false,
"hematological": false,
"infectious": false,
"lymphatic": false,
"mens": false,
"metabolic": false,
"musculoskeletal": false,
"neonatological": false,
"neurological": false,
"nutritional": false,
"oncological": false,
"ophthalmic": false,
"otolaryngological": false,
"pain": false,
"postSurgery": false,
"pulmonary": false,
"renal": false,
"spinal": false,
"stroke": false,
"toxicological": false,
"urological": false,
"womens": false
},
"medicationsOfInterest": [
{
"active": true,
"nameCode": {
"code": "6809",
"codeSystem": "2.16.840.1.113883.6.88",
"codeSystemName": "RxNorm",
"displayName": "metFORMIN"
},
"classCode": {
"code": "N0000175565",
"codeSystem": "2.16.840.1.113883.6.345",
"codeSystemName": "MED-RT",
"displayName": "Biguanide"
},
"scheduleCode": {
"code": "IV",
"codeSystem": "2.16.840.1.113883.12.477",
"codeSystemName": "Controlled Substance Schedule",
"displayName": "Schedule IV"
},
"medicationRequests": [
{
"code": {
"code": "861007",
"codeSystem": "2.16.840.1.113883.6.88",
"codeSystemName": "RxNorm",
"displayName": "metFORMIN hydrochloride 500 MG Oral Tablet"
},
"form": {
"code": "C42998",
"codeSystem": "2.16.840.1.113883.3.26.1.1",
"codeSystemName": "NCI Thesaurus",
"displayName": "tablet"
},
"route": {
"code": "C38288",
"codeSystem": "2.16.840.1.113883.3.26.1.1",
"codeSystemName": "NCI Thesaurus",
"displayName": "oral"
},
"prescribedDate": "2023-12-02",
"initialFillQuantity": 10,
"numberOfRefillsAllowed": 0,
"timingEvent": "QD",
"frequencyUnit": "d",
"frequencyValue": 1,
"dosageInstruction": {
"text": "take 1 tablet by mouth once daily",
"strengthUnit": "mg",
"strengthValue": 100,
"amountUnit": "puffs",
"amountValue": 2
}
}
]
}
],
"riskAdjustmentConfiguration": {},
"careManagementConfiguration": {},
"qualityMeasureConfiguration": {
"asOfDateOverride": "2025-12-31"
}
}
}
],
"batchId": "BATCH-123",
"patientPanelDirectives": {
"requestMedicationHistory": true,
"deliverableDocuments": [
"PATIENT_CARE_SUMMARY",
"QUALITY_MEASURES_SUMMARY"
],
"principalOid": "<string>"
}
}
'import requests
url = "https://processing-request-staging.connectivehealth.io/v2/patient-data/validate"
payload = {
"patientProcessingRequests": [
{
"patient": {
"mrn": {
"root": "1.2.3.4",
"extension": "ABC123"
},
"name": {
"family": "Johnson",
"given": ["John", "Aaron"],
"prefix": "Mr.",
"suffix": "Jr."
},
"birthDate": "1992-04-09",
"addresses": [
{
"lines": ["123 Main St", "Suite 517"],
"city": "Minneapolis",
"state": "MN",
"zip": "55401"
}
],
"contactPoints": [
{
"value": "9525551234",
"contactPointSystem": "PHONE",
"contactPointUse": "HOME"
}
]
},
"requestingProvider": {
"npi": "1414912117",
"name": {
"family": "Johnson",
"given": ["John", "Aaron"],
"prefix": "Mr.",
"suffix": "Jr."
}
},
"upcomingAppointmentDate": "2025-11-05",
"enrollmentDate": "2025-11-05",
"clinicName": "Simple Clinic Name",
"clinicNpi": "1414912117",
"responseDirectAddress": "contact@yourdomain.com",
"responseFriendlyName": "Heart Clinic",
"diagnoses": [
{
"code": "E66.01",
"codeSystem": "2.16.840.1.113883.6.90",
"displayName": "Morbid (severe) obesity due to excess calories",
"active": True,
"date": "2022-12-12"
}
],
"procedures": [
{
"date": "2022-12-12",
"code": {
"code": "44970",
"codeSystem": "2.16.840.1.113883.6.12",
"codeSystemName": "CPT",
"displayName": "Laparoscopy, surgical, appendectomy"
},
"targetSite": {
"code": "66754008",
"codeSystem": "2.16.840.1.113883.6.96",
"codeSystemName": "SNOMED CT",
"displayName": "Appendix structure"
},
"note": "Procedure was well tolerated"
}
],
"immunizations": [
{
"date": "2024-10-01",
"code": {
"code": "150",
"codeSystem": "2.16.840.1.113883.12.292",
"codeSystemName": "CVX",
"displayName": "Influenza, injectable, quadrivalent, preservative free"
}
}
],
"medications": [
{
"active": True,
"nameCode": {
"code": "6809",
"codeSystem": "2.16.840.1.113883.6.88",
"codeSystemName": "RxNorm",
"displayName": "metFORMIN"
},
"classCode": {
"code": "N0000175565",
"codeSystem": "2.16.840.1.113883.6.345",
"codeSystemName": "MED-RT",
"displayName": "Biguanide"
},
"scheduleCode": {
"code": "IV",
"codeSystem": "2.16.840.1.113883.12.477",
"codeSystemName": "Controlled Substance Schedule",
"displayName": "Schedule IV"
},
"medicationRequests": [
{
"code": {
"code": "861007",
"codeSystem": "2.16.840.1.113883.6.88",
"codeSystemName": "RxNorm",
"displayName": "metFORMIN hydrochloride 500 MG Oral Tablet"
},
"form": {
"code": "C42998",
"codeSystem": "2.16.840.1.113883.3.26.1.1",
"codeSystemName": "NCI Thesaurus",
"displayName": "tablet"
},
"route": {
"code": "C38288",
"codeSystem": "2.16.840.1.113883.3.26.1.1",
"codeSystemName": "NCI Thesaurus",
"displayName": "oral"
},
"prescribedDate": "2023-12-02",
"initialFillQuantity": 10,
"numberOfRefillsAllowed": 0,
"timingEvent": "QD",
"frequencyUnit": "d",
"frequencyValue": 1,
"dosageInstruction": {
"text": "take 1 tablet by mouth once daily",
"strengthUnit": "mg",
"strengthValue": 100,
"amountUnit": "puffs",
"amountValue": 2
}
}
]
}
],
"clinicalNotes": [
{
"lines": ["The patient was pleasant", "Recommend following up in 2 weeks"],
"date": "2022-12-12",
"code": {
"code": "11506-3",
"codeSystem": "2.16.840.1.113883.6.1",
"codeSystemName": "LOINC",
"displayName": "Progress Note"
}
}
],
"directives": {
"newPatient": False,
"useCase": "HIGH_RISK",
"diagnosticCategories": {
"autoimmune": False,
"bariatric": False,
"behavioral": False,
"cardiovascular": False,
"dental": False,
"dermatological": False,
"endocrinological": False,
"gastroenterological": False,
"generalInformation": False,
"generalSurgery": False,
"hematological": False,
"infectious": False,
"lymphatic": False,
"mens": False,
"metabolic": False,
"musculoskeletal": False,
"neonatological": False,
"neurological": False,
"nutritional": False,
"oncological": False,
"ophthalmic": False,
"otolaryngological": False,
"pain": False,
"postSurgery": False,
"pulmonary": False,
"renal": False,
"spinal": False,
"stroke": False,
"toxicological": False,
"urological": False,
"womens": False
},
"medicationsOfInterest": [
{
"active": True,
"nameCode": {
"code": "6809",
"codeSystem": "2.16.840.1.113883.6.88",
"codeSystemName": "RxNorm",
"displayName": "metFORMIN"
},
"classCode": {
"code": "N0000175565",
"codeSystem": "2.16.840.1.113883.6.345",
"codeSystemName": "MED-RT",
"displayName": "Biguanide"
},
"scheduleCode": {
"code": "IV",
"codeSystem": "2.16.840.1.113883.12.477",
"codeSystemName": "Controlled Substance Schedule",
"displayName": "Schedule IV"
},
"medicationRequests": [
{
"code": {
"code": "861007",
"codeSystem": "2.16.840.1.113883.6.88",
"codeSystemName": "RxNorm",
"displayName": "metFORMIN hydrochloride 500 MG Oral Tablet"
},
"form": {
"code": "C42998",
"codeSystem": "2.16.840.1.113883.3.26.1.1",
"codeSystemName": "NCI Thesaurus",
"displayName": "tablet"
},
"route": {
"code": "C38288",
"codeSystem": "2.16.840.1.113883.3.26.1.1",
"codeSystemName": "NCI Thesaurus",
"displayName": "oral"
},
"prescribedDate": "2023-12-02",
"initialFillQuantity": 10,
"numberOfRefillsAllowed": 0,
"timingEvent": "QD",
"frequencyUnit": "d",
"frequencyValue": 1,
"dosageInstruction": {
"text": "take 1 tablet by mouth once daily",
"strengthUnit": "mg",
"strengthValue": 100,
"amountUnit": "puffs",
"amountValue": 2
}
}
]
}
],
"riskAdjustmentConfiguration": {},
"careManagementConfiguration": {},
"qualityMeasureConfiguration": { "asOfDateOverride": "2025-12-31" }
}
}
],
"batchId": "BATCH-123",
"patientPanelDirectives": {
"requestMedicationHistory": True,
"deliverableDocuments": ["PATIENT_CARE_SUMMARY", "QUALITY_MEASURES_SUMMARY"],
"principalOid": "<string>"
}
}
headers = {
"apiKey": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {apiKey: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
patientProcessingRequests: [
{
patient: {
mrn: {root: '1.2.3.4', extension: 'ABC123'},
name: {family: 'Johnson', given: ['John', 'Aaron'], prefix: 'Mr.', suffix: 'Jr.'},
birthDate: '1992-04-09',
addresses: [
{
lines: ['123 Main St', 'Suite 517'],
city: 'Minneapolis',
state: 'MN',
zip: '55401'
}
],
contactPoints: [{value: '9525551234', contactPointSystem: 'PHONE', contactPointUse: 'HOME'}]
},
requestingProvider: {
npi: '1414912117',
name: {family: 'Johnson', given: ['John', 'Aaron'], prefix: 'Mr.', suffix: 'Jr.'}
},
upcomingAppointmentDate: '2025-11-05',
enrollmentDate: '2025-11-05',
clinicName: 'Simple Clinic Name',
clinicNpi: '1414912117',
responseDirectAddress: 'contact@yourdomain.com',
responseFriendlyName: 'Heart Clinic',
diagnoses: [
{
code: 'E66.01',
codeSystem: '2.16.840.1.113883.6.90',
displayName: 'Morbid (severe) obesity due to excess calories',
active: true,
date: '2022-12-12'
}
],
procedures: [
{
date: '2022-12-12',
code: {
code: '44970',
codeSystem: '2.16.840.1.113883.6.12',
codeSystemName: 'CPT',
displayName: 'Laparoscopy, surgical, appendectomy'
},
targetSite: {
code: '66754008',
codeSystem: '2.16.840.1.113883.6.96',
codeSystemName: 'SNOMED CT',
displayName: 'Appendix structure'
},
note: 'Procedure was well tolerated'
}
],
immunizations: [
{
date: '2024-10-01',
code: {
code: '150',
codeSystem: '2.16.840.1.113883.12.292',
codeSystemName: 'CVX',
displayName: 'Influenza, injectable, quadrivalent, preservative free'
}
}
],
medications: [
{
active: true,
nameCode: {
code: '6809',
codeSystem: '2.16.840.1.113883.6.88',
codeSystemName: 'RxNorm',
displayName: 'metFORMIN'
},
classCode: {
code: 'N0000175565',
codeSystem: '2.16.840.1.113883.6.345',
codeSystemName: 'MED-RT',
displayName: 'Biguanide'
},
scheduleCode: {
code: 'IV',
codeSystem: '2.16.840.1.113883.12.477',
codeSystemName: 'Controlled Substance Schedule',
displayName: 'Schedule IV'
},
medicationRequests: [
{
code: {
code: '861007',
codeSystem: '2.16.840.1.113883.6.88',
codeSystemName: 'RxNorm',
displayName: 'metFORMIN hydrochloride 500 MG Oral Tablet'
},
form: {
code: 'C42998',
codeSystem: '2.16.840.1.113883.3.26.1.1',
codeSystemName: 'NCI Thesaurus',
displayName: 'tablet'
},
route: {
code: 'C38288',
codeSystem: '2.16.840.1.113883.3.26.1.1',
codeSystemName: 'NCI Thesaurus',
displayName: 'oral'
},
prescribedDate: '2023-12-02',
initialFillQuantity: 10,
numberOfRefillsAllowed: 0,
timingEvent: 'QD',
frequencyUnit: 'd',
frequencyValue: 1,
dosageInstruction: {
text: 'take 1 tablet by mouth once daily',
strengthUnit: 'mg',
strengthValue: 100,
amountUnit: 'puffs',
amountValue: 2
}
}
]
}
],
clinicalNotes: [
{
lines: ['The patient was pleasant', 'Recommend following up in 2 weeks'],
date: '2022-12-12',
code: {
code: '11506-3',
codeSystem: '2.16.840.1.113883.6.1',
codeSystemName: 'LOINC',
displayName: 'Progress Note'
}
}
],
directives: {
newPatient: false,
useCase: 'HIGH_RISK',
diagnosticCategories: {
autoimmune: false,
bariatric: false,
behavioral: false,
cardiovascular: false,
dental: false,
dermatological: false,
endocrinological: false,
gastroenterological: false,
generalInformation: false,
generalSurgery: false,
hematological: false,
infectious: false,
lymphatic: false,
mens: false,
metabolic: false,
musculoskeletal: false,
neonatological: false,
neurological: false,
nutritional: false,
oncological: false,
ophthalmic: false,
otolaryngological: false,
pain: false,
postSurgery: false,
pulmonary: false,
renal: false,
spinal: false,
stroke: false,
toxicological: false,
urological: false,
womens: false
},
medicationsOfInterest: [
{
active: true,
nameCode: {
code: '6809',
codeSystem: '2.16.840.1.113883.6.88',
codeSystemName: 'RxNorm',
displayName: 'metFORMIN'
},
classCode: {
code: 'N0000175565',
codeSystem: '2.16.840.1.113883.6.345',
codeSystemName: 'MED-RT',
displayName: 'Biguanide'
},
scheduleCode: {
code: 'IV',
codeSystem: '2.16.840.1.113883.12.477',
codeSystemName: 'Controlled Substance Schedule',
displayName: 'Schedule IV'
},
medicationRequests: [
{
code: {
code: '861007',
codeSystem: '2.16.840.1.113883.6.88',
codeSystemName: 'RxNorm',
displayName: 'metFORMIN hydrochloride 500 MG Oral Tablet'
},
form: {
code: 'C42998',
codeSystem: '2.16.840.1.113883.3.26.1.1',
codeSystemName: 'NCI Thesaurus',
displayName: 'tablet'
},
route: {
code: 'C38288',
codeSystem: '2.16.840.1.113883.3.26.1.1',
codeSystemName: 'NCI Thesaurus',
displayName: 'oral'
},
prescribedDate: '2023-12-02',
initialFillQuantity: 10,
numberOfRefillsAllowed: 0,
timingEvent: 'QD',
frequencyUnit: 'd',
frequencyValue: 1,
dosageInstruction: {
text: 'take 1 tablet by mouth once daily',
strengthUnit: 'mg',
strengthValue: 100,
amountUnit: 'puffs',
amountValue: 2
}
}
]
}
],
riskAdjustmentConfiguration: {},
careManagementConfiguration: {},
qualityMeasureConfiguration: {asOfDateOverride: '2025-12-31'}
}
}
],
batchId: 'BATCH-123',
patientPanelDirectives: {
requestMedicationHistory: true,
deliverableDocuments: ['PATIENT_CARE_SUMMARY', 'QUALITY_MEASURES_SUMMARY'],
principalOid: '<string>'
}
})
};
fetch('https://processing-request-staging.connectivehealth.io/v2/patient-data/validate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://processing-request-staging.connectivehealth.io/v2/patient-data/validate",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'patientProcessingRequests' => [
[
'patient' => [
'mrn' => [
'root' => '1.2.3.4',
'extension' => 'ABC123'
],
'name' => [
'family' => 'Johnson',
'given' => [
'John',
'Aaron'
],
'prefix' => 'Mr.',
'suffix' => 'Jr.'
],
'birthDate' => '1992-04-09',
'addresses' => [
[
'lines' => [
'123 Main St',
'Suite 517'
],
'city' => 'Minneapolis',
'state' => 'MN',
'zip' => '55401'
]
],
'contactPoints' => [
[
'value' => '9525551234',
'contactPointSystem' => 'PHONE',
'contactPointUse' => 'HOME'
]
]
],
'requestingProvider' => [
'npi' => '1414912117',
'name' => [
'family' => 'Johnson',
'given' => [
'John',
'Aaron'
],
'prefix' => 'Mr.',
'suffix' => 'Jr.'
]
],
'upcomingAppointmentDate' => '2025-11-05',
'enrollmentDate' => '2025-11-05',
'clinicName' => 'Simple Clinic Name',
'clinicNpi' => '1414912117',
'responseDirectAddress' => 'contact@yourdomain.com',
'responseFriendlyName' => 'Heart Clinic',
'diagnoses' => [
[
'code' => 'E66.01',
'codeSystem' => '2.16.840.1.113883.6.90',
'displayName' => 'Morbid (severe) obesity due to excess calories',
'active' => true,
'date' => '2022-12-12'
]
],
'procedures' => [
[
'date' => '2022-12-12',
'code' => [
'code' => '44970',
'codeSystem' => '2.16.840.1.113883.6.12',
'codeSystemName' => 'CPT',
'displayName' => 'Laparoscopy, surgical, appendectomy'
],
'targetSite' => [
'code' => '66754008',
'codeSystem' => '2.16.840.1.113883.6.96',
'codeSystemName' => 'SNOMED CT',
'displayName' => 'Appendix structure'
],
'note' => 'Procedure was well tolerated'
]
],
'immunizations' => [
[
'date' => '2024-10-01',
'code' => [
'code' => '150',
'codeSystem' => '2.16.840.1.113883.12.292',
'codeSystemName' => 'CVX',
'displayName' => 'Influenza, injectable, quadrivalent, preservative free'
]
]
],
'medications' => [
[
'active' => true,
'nameCode' => [
'code' => '6809',
'codeSystem' => '2.16.840.1.113883.6.88',
'codeSystemName' => 'RxNorm',
'displayName' => 'metFORMIN'
],
'classCode' => [
'code' => 'N0000175565',
'codeSystem' => '2.16.840.1.113883.6.345',
'codeSystemName' => 'MED-RT',
'displayName' => 'Biguanide'
],
'scheduleCode' => [
'code' => 'IV',
'codeSystem' => '2.16.840.1.113883.12.477',
'codeSystemName' => 'Controlled Substance Schedule',
'displayName' => 'Schedule IV'
],
'medicationRequests' => [
[
'code' => [
'code' => '861007',
'codeSystem' => '2.16.840.1.113883.6.88',
'codeSystemName' => 'RxNorm',
'displayName' => 'metFORMIN hydrochloride 500 MG Oral Tablet'
],
'form' => [
'code' => 'C42998',
'codeSystem' => '2.16.840.1.113883.3.26.1.1',
'codeSystemName' => 'NCI Thesaurus',
'displayName' => 'tablet'
],
'route' => [
'code' => 'C38288',
'codeSystem' => '2.16.840.1.113883.3.26.1.1',
'codeSystemName' => 'NCI Thesaurus',
'displayName' => 'oral'
],
'prescribedDate' => '2023-12-02',
'initialFillQuantity' => 10,
'numberOfRefillsAllowed' => 0,
'timingEvent' => 'QD',
'frequencyUnit' => 'd',
'frequencyValue' => 1,
'dosageInstruction' => [
'text' => 'take 1 tablet by mouth once daily',
'strengthUnit' => 'mg',
'strengthValue' => 100,
'amountUnit' => 'puffs',
'amountValue' => 2
]
]
]
]
],
'clinicalNotes' => [
[
'lines' => [
'The patient was pleasant',
'Recommend following up in 2 weeks'
],
'date' => '2022-12-12',
'code' => [
'code' => '11506-3',
'codeSystem' => '2.16.840.1.113883.6.1',
'codeSystemName' => 'LOINC',
'displayName' => 'Progress Note'
]
]
],
'directives' => [
'newPatient' => false,
'useCase' => 'HIGH_RISK',
'diagnosticCategories' => [
'autoimmune' => false,
'bariatric' => false,
'behavioral' => false,
'cardiovascular' => false,
'dental' => false,
'dermatological' => false,
'endocrinological' => false,
'gastroenterological' => false,
'generalInformation' => false,
'generalSurgery' => false,
'hematological' => false,
'infectious' => false,
'lymphatic' => false,
'mens' => false,
'metabolic' => false,
'musculoskeletal' => false,
'neonatological' => false,
'neurological' => false,
'nutritional' => false,
'oncological' => false,
'ophthalmic' => false,
'otolaryngological' => false,
'pain' => false,
'postSurgery' => false,
'pulmonary' => false,
'renal' => false,
'spinal' => false,
'stroke' => false,
'toxicological' => false,
'urological' => false,
'womens' => false
],
'medicationsOfInterest' => [
[
'active' => true,
'nameCode' => [
'code' => '6809',
'codeSystem' => '2.16.840.1.113883.6.88',
'codeSystemName' => 'RxNorm',
'displayName' => 'metFORMIN'
],
'classCode' => [
'code' => 'N0000175565',
'codeSystem' => '2.16.840.1.113883.6.345',
'codeSystemName' => 'MED-RT',
'displayName' => 'Biguanide'
],
'scheduleCode' => [
'code' => 'IV',
'codeSystem' => '2.16.840.1.113883.12.477',
'codeSystemName' => 'Controlled Substance Schedule',
'displayName' => 'Schedule IV'
],
'medicationRequests' => [
[
'code' => [
'code' => '861007',
'codeSystem' => '2.16.840.1.113883.6.88',
'codeSystemName' => 'RxNorm',
'displayName' => 'metFORMIN hydrochloride 500 MG Oral Tablet'
],
'form' => [
'code' => 'C42998',
'codeSystem' => '2.16.840.1.113883.3.26.1.1',
'codeSystemName' => 'NCI Thesaurus',
'displayName' => 'tablet'
],
'route' => [
'code' => 'C38288',
'codeSystem' => '2.16.840.1.113883.3.26.1.1',
'codeSystemName' => 'NCI Thesaurus',
'displayName' => 'oral'
],
'prescribedDate' => '2023-12-02',
'initialFillQuantity' => 10,
'numberOfRefillsAllowed' => 0,
'timingEvent' => 'QD',
'frequencyUnit' => 'd',
'frequencyValue' => 1,
'dosageInstruction' => [
'text' => 'take 1 tablet by mouth once daily',
'strengthUnit' => 'mg',
'strengthValue' => 100,
'amountUnit' => 'puffs',
'amountValue' => 2
]
]
]
]
],
'riskAdjustmentConfiguration' => [
],
'careManagementConfiguration' => [
],
'qualityMeasureConfiguration' => [
'asOfDateOverride' => '2025-12-31'
]
]
]
],
'batchId' => 'BATCH-123',
'patientPanelDirectives' => [
'requestMedicationHistory' => true,
'deliverableDocuments' => [
'PATIENT_CARE_SUMMARY',
'QUALITY_MEASURES_SUMMARY'
],
'principalOid' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"apiKey: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://processing-request-staging.connectivehealth.io/v2/patient-data/validate"
payload := strings.NewReader("{\n \"patientProcessingRequests\": [\n {\n \"patient\": {\n \"mrn\": {\n \"root\": \"1.2.3.4\",\n \"extension\": \"ABC123\"\n },\n \"name\": {\n \"family\": \"Johnson\",\n \"given\": [\n \"John\",\n \"Aaron\"\n ],\n \"prefix\": \"Mr.\",\n \"suffix\": \"Jr.\"\n },\n \"birthDate\": \"1992-04-09\",\n \"addresses\": [\n {\n \"lines\": [\n \"123 Main St\",\n \"Suite 517\"\n ],\n \"city\": \"Minneapolis\",\n \"state\": \"MN\",\n \"zip\": \"55401\"\n }\n ],\n \"contactPoints\": [\n {\n \"value\": \"9525551234\",\n \"contactPointSystem\": \"PHONE\",\n \"contactPointUse\": \"HOME\"\n }\n ]\n },\n \"requestingProvider\": {\n \"npi\": \"1414912117\",\n \"name\": {\n \"family\": \"Johnson\",\n \"given\": [\n \"John\",\n \"Aaron\"\n ],\n \"prefix\": \"Mr.\",\n \"suffix\": \"Jr.\"\n }\n },\n \"upcomingAppointmentDate\": \"2025-11-05\",\n \"enrollmentDate\": \"2025-11-05\",\n \"clinicName\": \"Simple Clinic Name\",\n \"clinicNpi\": \"1414912117\",\n \"responseDirectAddress\": \"contact@yourdomain.com\",\n \"responseFriendlyName\": \"Heart Clinic\",\n \"diagnoses\": [\n {\n \"code\": \"E66.01\",\n \"codeSystem\": \"2.16.840.1.113883.6.90\",\n \"displayName\": \"Morbid (severe) obesity due to excess calories\",\n \"active\": true,\n \"date\": \"2022-12-12\"\n }\n ],\n \"procedures\": [\n {\n \"date\": \"2022-12-12\",\n \"code\": {\n \"code\": \"44970\",\n \"codeSystem\": \"2.16.840.1.113883.6.12\",\n \"codeSystemName\": \"CPT\",\n \"displayName\": \"Laparoscopy, surgical, appendectomy\"\n },\n \"targetSite\": {\n \"code\": \"66754008\",\n \"codeSystem\": \"2.16.840.1.113883.6.96\",\n \"codeSystemName\": \"SNOMED CT\",\n \"displayName\": \"Appendix structure\"\n },\n \"note\": \"Procedure was well tolerated\"\n }\n ],\n \"immunizations\": [\n {\n \"date\": \"2024-10-01\",\n \"code\": {\n \"code\": \"150\",\n \"codeSystem\": \"2.16.840.1.113883.12.292\",\n \"codeSystemName\": \"CVX\",\n \"displayName\": \"Influenza, injectable, quadrivalent, preservative free\"\n }\n }\n ],\n \"medications\": [\n {\n \"active\": true,\n \"nameCode\": {\n \"code\": \"6809\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN\"\n },\n \"classCode\": {\n \"code\": \"N0000175565\",\n \"codeSystem\": \"2.16.840.1.113883.6.345\",\n \"codeSystemName\": \"MED-RT\",\n \"displayName\": \"Biguanide\"\n },\n \"scheduleCode\": {\n \"code\": \"IV\",\n \"codeSystem\": \"2.16.840.1.113883.12.477\",\n \"codeSystemName\": \"Controlled Substance Schedule\",\n \"displayName\": \"Schedule IV\"\n },\n \"medicationRequests\": [\n {\n \"code\": {\n \"code\": \"861007\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN hydrochloride 500 MG Oral Tablet\"\n },\n \"form\": {\n \"code\": \"C42998\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"tablet\"\n },\n \"route\": {\n \"code\": \"C38288\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"oral\"\n },\n \"prescribedDate\": \"2023-12-02\",\n \"initialFillQuantity\": 10,\n \"numberOfRefillsAllowed\": 0,\n \"timingEvent\": \"QD\",\n \"frequencyUnit\": \"d\",\n \"frequencyValue\": 1,\n \"dosageInstruction\": {\n \"text\": \"take 1 tablet by mouth once daily\",\n \"strengthUnit\": \"mg\",\n \"strengthValue\": 100,\n \"amountUnit\": \"puffs\",\n \"amountValue\": 2\n }\n }\n ]\n }\n ],\n \"clinicalNotes\": [\n {\n \"lines\": [\n \"The patient was pleasant\",\n \"Recommend following up in 2 weeks\"\n ],\n \"date\": \"2022-12-12\",\n \"code\": {\n \"code\": \"11506-3\",\n \"codeSystem\": \"2.16.840.1.113883.6.1\",\n \"codeSystemName\": \"LOINC\",\n \"displayName\": \"Progress Note\"\n }\n }\n ],\n \"directives\": {\n \"newPatient\": false,\n \"useCase\": \"HIGH_RISK\",\n \"diagnosticCategories\": {\n \"autoimmune\": false,\n \"bariatric\": false,\n \"behavioral\": false,\n \"cardiovascular\": false,\n \"dental\": false,\n \"dermatological\": false,\n \"endocrinological\": false,\n \"gastroenterological\": false,\n \"generalInformation\": false,\n \"generalSurgery\": false,\n \"hematological\": false,\n \"infectious\": false,\n \"lymphatic\": false,\n \"mens\": false,\n \"metabolic\": false,\n \"musculoskeletal\": false,\n \"neonatological\": false,\n \"neurological\": false,\n \"nutritional\": false,\n \"oncological\": false,\n \"ophthalmic\": false,\n \"otolaryngological\": false,\n \"pain\": false,\n \"postSurgery\": false,\n \"pulmonary\": false,\n \"renal\": false,\n \"spinal\": false,\n \"stroke\": false,\n \"toxicological\": false,\n \"urological\": false,\n \"womens\": false\n },\n \"medicationsOfInterest\": [\n {\n \"active\": true,\n \"nameCode\": {\n \"code\": \"6809\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN\"\n },\n \"classCode\": {\n \"code\": \"N0000175565\",\n \"codeSystem\": \"2.16.840.1.113883.6.345\",\n \"codeSystemName\": \"MED-RT\",\n \"displayName\": \"Biguanide\"\n },\n \"scheduleCode\": {\n \"code\": \"IV\",\n \"codeSystem\": \"2.16.840.1.113883.12.477\",\n \"codeSystemName\": \"Controlled Substance Schedule\",\n \"displayName\": \"Schedule IV\"\n },\n \"medicationRequests\": [\n {\n \"code\": {\n \"code\": \"861007\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN hydrochloride 500 MG Oral Tablet\"\n },\n \"form\": {\n \"code\": \"C42998\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"tablet\"\n },\n \"route\": {\n \"code\": \"C38288\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"oral\"\n },\n \"prescribedDate\": \"2023-12-02\",\n \"initialFillQuantity\": 10,\n \"numberOfRefillsAllowed\": 0,\n \"timingEvent\": \"QD\",\n \"frequencyUnit\": \"d\",\n \"frequencyValue\": 1,\n \"dosageInstruction\": {\n \"text\": \"take 1 tablet by mouth once daily\",\n \"strengthUnit\": \"mg\",\n \"strengthValue\": 100,\n \"amountUnit\": \"puffs\",\n \"amountValue\": 2\n }\n }\n ]\n }\n ],\n \"riskAdjustmentConfiguration\": {},\n \"careManagementConfiguration\": {},\n \"qualityMeasureConfiguration\": {\n \"asOfDateOverride\": \"2025-12-31\"\n }\n }\n }\n ],\n \"batchId\": \"BATCH-123\",\n \"patientPanelDirectives\": {\n \"requestMedicationHistory\": true,\n \"deliverableDocuments\": [\n \"PATIENT_CARE_SUMMARY\",\n \"QUALITY_MEASURES_SUMMARY\"\n ],\n \"principalOid\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("apiKey", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://processing-request-staging.connectivehealth.io/v2/patient-data/validate")
.header("apiKey", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"patientProcessingRequests\": [\n {\n \"patient\": {\n \"mrn\": {\n \"root\": \"1.2.3.4\",\n \"extension\": \"ABC123\"\n },\n \"name\": {\n \"family\": \"Johnson\",\n \"given\": [\n \"John\",\n \"Aaron\"\n ],\n \"prefix\": \"Mr.\",\n \"suffix\": \"Jr.\"\n },\n \"birthDate\": \"1992-04-09\",\n \"addresses\": [\n {\n \"lines\": [\n \"123 Main St\",\n \"Suite 517\"\n ],\n \"city\": \"Minneapolis\",\n \"state\": \"MN\",\n \"zip\": \"55401\"\n }\n ],\n \"contactPoints\": [\n {\n \"value\": \"9525551234\",\n \"contactPointSystem\": \"PHONE\",\n \"contactPointUse\": \"HOME\"\n }\n ]\n },\n \"requestingProvider\": {\n \"npi\": \"1414912117\",\n \"name\": {\n \"family\": \"Johnson\",\n \"given\": [\n \"John\",\n \"Aaron\"\n ],\n \"prefix\": \"Mr.\",\n \"suffix\": \"Jr.\"\n }\n },\n \"upcomingAppointmentDate\": \"2025-11-05\",\n \"enrollmentDate\": \"2025-11-05\",\n \"clinicName\": \"Simple Clinic Name\",\n \"clinicNpi\": \"1414912117\",\n \"responseDirectAddress\": \"contact@yourdomain.com\",\n \"responseFriendlyName\": \"Heart Clinic\",\n \"diagnoses\": [\n {\n \"code\": \"E66.01\",\n \"codeSystem\": \"2.16.840.1.113883.6.90\",\n \"displayName\": \"Morbid (severe) obesity due to excess calories\",\n \"active\": true,\n \"date\": \"2022-12-12\"\n }\n ],\n \"procedures\": [\n {\n \"date\": \"2022-12-12\",\n \"code\": {\n \"code\": \"44970\",\n \"codeSystem\": \"2.16.840.1.113883.6.12\",\n \"codeSystemName\": \"CPT\",\n \"displayName\": \"Laparoscopy, surgical, appendectomy\"\n },\n \"targetSite\": {\n \"code\": \"66754008\",\n \"codeSystem\": \"2.16.840.1.113883.6.96\",\n \"codeSystemName\": \"SNOMED CT\",\n \"displayName\": \"Appendix structure\"\n },\n \"note\": \"Procedure was well tolerated\"\n }\n ],\n \"immunizations\": [\n {\n \"date\": \"2024-10-01\",\n \"code\": {\n \"code\": \"150\",\n \"codeSystem\": \"2.16.840.1.113883.12.292\",\n \"codeSystemName\": \"CVX\",\n \"displayName\": \"Influenza, injectable, quadrivalent, preservative free\"\n }\n }\n ],\n \"medications\": [\n {\n \"active\": true,\n \"nameCode\": {\n \"code\": \"6809\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN\"\n },\n \"classCode\": {\n \"code\": \"N0000175565\",\n \"codeSystem\": \"2.16.840.1.113883.6.345\",\n \"codeSystemName\": \"MED-RT\",\n \"displayName\": \"Biguanide\"\n },\n \"scheduleCode\": {\n \"code\": \"IV\",\n \"codeSystem\": \"2.16.840.1.113883.12.477\",\n \"codeSystemName\": \"Controlled Substance Schedule\",\n \"displayName\": \"Schedule IV\"\n },\n \"medicationRequests\": [\n {\n \"code\": {\n \"code\": \"861007\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN hydrochloride 500 MG Oral Tablet\"\n },\n \"form\": {\n \"code\": \"C42998\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"tablet\"\n },\n \"route\": {\n \"code\": \"C38288\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"oral\"\n },\n \"prescribedDate\": \"2023-12-02\",\n \"initialFillQuantity\": 10,\n \"numberOfRefillsAllowed\": 0,\n \"timingEvent\": \"QD\",\n \"frequencyUnit\": \"d\",\n \"frequencyValue\": 1,\n \"dosageInstruction\": {\n \"text\": \"take 1 tablet by mouth once daily\",\n \"strengthUnit\": \"mg\",\n \"strengthValue\": 100,\n \"amountUnit\": \"puffs\",\n \"amountValue\": 2\n }\n }\n ]\n }\n ],\n \"clinicalNotes\": [\n {\n \"lines\": [\n \"The patient was pleasant\",\n \"Recommend following up in 2 weeks\"\n ],\n \"date\": \"2022-12-12\",\n \"code\": {\n \"code\": \"11506-3\",\n \"codeSystem\": \"2.16.840.1.113883.6.1\",\n \"codeSystemName\": \"LOINC\",\n \"displayName\": \"Progress Note\"\n }\n }\n ],\n \"directives\": {\n \"newPatient\": false,\n \"useCase\": \"HIGH_RISK\",\n \"diagnosticCategories\": {\n \"autoimmune\": false,\n \"bariatric\": false,\n \"behavioral\": false,\n \"cardiovascular\": false,\n \"dental\": false,\n \"dermatological\": false,\n \"endocrinological\": false,\n \"gastroenterological\": false,\n \"generalInformation\": false,\n \"generalSurgery\": false,\n \"hematological\": false,\n \"infectious\": false,\n \"lymphatic\": false,\n \"mens\": false,\n \"metabolic\": false,\n \"musculoskeletal\": false,\n \"neonatological\": false,\n \"neurological\": false,\n \"nutritional\": false,\n \"oncological\": false,\n \"ophthalmic\": false,\n \"otolaryngological\": false,\n \"pain\": false,\n \"postSurgery\": false,\n \"pulmonary\": false,\n \"renal\": false,\n \"spinal\": false,\n \"stroke\": false,\n \"toxicological\": false,\n \"urological\": false,\n \"womens\": false\n },\n \"medicationsOfInterest\": [\n {\n \"active\": true,\n \"nameCode\": {\n \"code\": \"6809\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN\"\n },\n \"classCode\": {\n \"code\": \"N0000175565\",\n \"codeSystem\": \"2.16.840.1.113883.6.345\",\n \"codeSystemName\": \"MED-RT\",\n \"displayName\": \"Biguanide\"\n },\n \"scheduleCode\": {\n \"code\": \"IV\",\n \"codeSystem\": \"2.16.840.1.113883.12.477\",\n \"codeSystemName\": \"Controlled Substance Schedule\",\n \"displayName\": \"Schedule IV\"\n },\n \"medicationRequests\": [\n {\n \"code\": {\n \"code\": \"861007\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN hydrochloride 500 MG Oral Tablet\"\n },\n \"form\": {\n \"code\": \"C42998\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"tablet\"\n },\n \"route\": {\n \"code\": \"C38288\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"oral\"\n },\n \"prescribedDate\": \"2023-12-02\",\n \"initialFillQuantity\": 10,\n \"numberOfRefillsAllowed\": 0,\n \"timingEvent\": \"QD\",\n \"frequencyUnit\": \"d\",\n \"frequencyValue\": 1,\n \"dosageInstruction\": {\n \"text\": \"take 1 tablet by mouth once daily\",\n \"strengthUnit\": \"mg\",\n \"strengthValue\": 100,\n \"amountUnit\": \"puffs\",\n \"amountValue\": 2\n }\n }\n ]\n }\n ],\n \"riskAdjustmentConfiguration\": {},\n \"careManagementConfiguration\": {},\n \"qualityMeasureConfiguration\": {\n \"asOfDateOverride\": \"2025-12-31\"\n }\n }\n }\n ],\n \"batchId\": \"BATCH-123\",\n \"patientPanelDirectives\": {\n \"requestMedicationHistory\": true,\n \"deliverableDocuments\": [\n \"PATIENT_CARE_SUMMARY\",\n \"QUALITY_MEASURES_SUMMARY\"\n ],\n \"principalOid\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://processing-request-staging.connectivehealth.io/v2/patient-data/validate")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["apiKey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"patientProcessingRequests\": [\n {\n \"patient\": {\n \"mrn\": {\n \"root\": \"1.2.3.4\",\n \"extension\": \"ABC123\"\n },\n \"name\": {\n \"family\": \"Johnson\",\n \"given\": [\n \"John\",\n \"Aaron\"\n ],\n \"prefix\": \"Mr.\",\n \"suffix\": \"Jr.\"\n },\n \"birthDate\": \"1992-04-09\",\n \"addresses\": [\n {\n \"lines\": [\n \"123 Main St\",\n \"Suite 517\"\n ],\n \"city\": \"Minneapolis\",\n \"state\": \"MN\",\n \"zip\": \"55401\"\n }\n ],\n \"contactPoints\": [\n {\n \"value\": \"9525551234\",\n \"contactPointSystem\": \"PHONE\",\n \"contactPointUse\": \"HOME\"\n }\n ]\n },\n \"requestingProvider\": {\n \"npi\": \"1414912117\",\n \"name\": {\n \"family\": \"Johnson\",\n \"given\": [\n \"John\",\n \"Aaron\"\n ],\n \"prefix\": \"Mr.\",\n \"suffix\": \"Jr.\"\n }\n },\n \"upcomingAppointmentDate\": \"2025-11-05\",\n \"enrollmentDate\": \"2025-11-05\",\n \"clinicName\": \"Simple Clinic Name\",\n \"clinicNpi\": \"1414912117\",\n \"responseDirectAddress\": \"contact@yourdomain.com\",\n \"responseFriendlyName\": \"Heart Clinic\",\n \"diagnoses\": [\n {\n \"code\": \"E66.01\",\n \"codeSystem\": \"2.16.840.1.113883.6.90\",\n \"displayName\": \"Morbid (severe) obesity due to excess calories\",\n \"active\": true,\n \"date\": \"2022-12-12\"\n }\n ],\n \"procedures\": [\n {\n \"date\": \"2022-12-12\",\n \"code\": {\n \"code\": \"44970\",\n \"codeSystem\": \"2.16.840.1.113883.6.12\",\n \"codeSystemName\": \"CPT\",\n \"displayName\": \"Laparoscopy, surgical, appendectomy\"\n },\n \"targetSite\": {\n \"code\": \"66754008\",\n \"codeSystem\": \"2.16.840.1.113883.6.96\",\n \"codeSystemName\": \"SNOMED CT\",\n \"displayName\": \"Appendix structure\"\n },\n \"note\": \"Procedure was well tolerated\"\n }\n ],\n \"immunizations\": [\n {\n \"date\": \"2024-10-01\",\n \"code\": {\n \"code\": \"150\",\n \"codeSystem\": \"2.16.840.1.113883.12.292\",\n \"codeSystemName\": \"CVX\",\n \"displayName\": \"Influenza, injectable, quadrivalent, preservative free\"\n }\n }\n ],\n \"medications\": [\n {\n \"active\": true,\n \"nameCode\": {\n \"code\": \"6809\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN\"\n },\n \"classCode\": {\n \"code\": \"N0000175565\",\n \"codeSystem\": \"2.16.840.1.113883.6.345\",\n \"codeSystemName\": \"MED-RT\",\n \"displayName\": \"Biguanide\"\n },\n \"scheduleCode\": {\n \"code\": \"IV\",\n \"codeSystem\": \"2.16.840.1.113883.12.477\",\n \"codeSystemName\": \"Controlled Substance Schedule\",\n \"displayName\": \"Schedule IV\"\n },\n \"medicationRequests\": [\n {\n \"code\": {\n \"code\": \"861007\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN hydrochloride 500 MG Oral Tablet\"\n },\n \"form\": {\n \"code\": \"C42998\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"tablet\"\n },\n \"route\": {\n \"code\": \"C38288\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"oral\"\n },\n \"prescribedDate\": \"2023-12-02\",\n \"initialFillQuantity\": 10,\n \"numberOfRefillsAllowed\": 0,\n \"timingEvent\": \"QD\",\n \"frequencyUnit\": \"d\",\n \"frequencyValue\": 1,\n \"dosageInstruction\": {\n \"text\": \"take 1 tablet by mouth once daily\",\n \"strengthUnit\": \"mg\",\n \"strengthValue\": 100,\n \"amountUnit\": \"puffs\",\n \"amountValue\": 2\n }\n }\n ]\n }\n ],\n \"clinicalNotes\": [\n {\n \"lines\": [\n \"The patient was pleasant\",\n \"Recommend following up in 2 weeks\"\n ],\n \"date\": \"2022-12-12\",\n \"code\": {\n \"code\": \"11506-3\",\n \"codeSystem\": \"2.16.840.1.113883.6.1\",\n \"codeSystemName\": \"LOINC\",\n \"displayName\": \"Progress Note\"\n }\n }\n ],\n \"directives\": {\n \"newPatient\": false,\n \"useCase\": \"HIGH_RISK\",\n \"diagnosticCategories\": {\n \"autoimmune\": false,\n \"bariatric\": false,\n \"behavioral\": false,\n \"cardiovascular\": false,\n \"dental\": false,\n \"dermatological\": false,\n \"endocrinological\": false,\n \"gastroenterological\": false,\n \"generalInformation\": false,\n \"generalSurgery\": false,\n \"hematological\": false,\n \"infectious\": false,\n \"lymphatic\": false,\n \"mens\": false,\n \"metabolic\": false,\n \"musculoskeletal\": false,\n \"neonatological\": false,\n \"neurological\": false,\n \"nutritional\": false,\n \"oncological\": false,\n \"ophthalmic\": false,\n \"otolaryngological\": false,\n \"pain\": false,\n \"postSurgery\": false,\n \"pulmonary\": false,\n \"renal\": false,\n \"spinal\": false,\n \"stroke\": false,\n \"toxicological\": false,\n \"urological\": false,\n \"womens\": false\n },\n \"medicationsOfInterest\": [\n {\n \"active\": true,\n \"nameCode\": {\n \"code\": \"6809\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN\"\n },\n \"classCode\": {\n \"code\": \"N0000175565\",\n \"codeSystem\": \"2.16.840.1.113883.6.345\",\n \"codeSystemName\": \"MED-RT\",\n \"displayName\": \"Biguanide\"\n },\n \"scheduleCode\": {\n \"code\": \"IV\",\n \"codeSystem\": \"2.16.840.1.113883.12.477\",\n \"codeSystemName\": \"Controlled Substance Schedule\",\n \"displayName\": \"Schedule IV\"\n },\n \"medicationRequests\": [\n {\n \"code\": {\n \"code\": \"861007\",\n \"codeSystem\": \"2.16.840.1.113883.6.88\",\n \"codeSystemName\": \"RxNorm\",\n \"displayName\": \"metFORMIN hydrochloride 500 MG Oral Tablet\"\n },\n \"form\": {\n \"code\": \"C42998\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"tablet\"\n },\n \"route\": {\n \"code\": \"C38288\",\n \"codeSystem\": \"2.16.840.1.113883.3.26.1.1\",\n \"codeSystemName\": \"NCI Thesaurus\",\n \"displayName\": \"oral\"\n },\n \"prescribedDate\": \"2023-12-02\",\n \"initialFillQuantity\": 10,\n \"numberOfRefillsAllowed\": 0,\n \"timingEvent\": \"QD\",\n \"frequencyUnit\": \"d\",\n \"frequencyValue\": 1,\n \"dosageInstruction\": {\n \"text\": \"take 1 tablet by mouth once daily\",\n \"strengthUnit\": \"mg\",\n \"strengthValue\": 100,\n \"amountUnit\": \"puffs\",\n \"amountValue\": 2\n }\n }\n ]\n }\n ],\n \"riskAdjustmentConfiguration\": {},\n \"careManagementConfiguration\": {},\n \"qualityMeasureConfiguration\": {\n \"asOfDateOverride\": \"2025-12-31\"\n }\n }\n }\n ],\n \"batchId\": \"BATCH-123\",\n \"patientPanelDirectives\": {\n \"requestMedicationHistory\": true,\n \"deliverableDocuments\": [\n \"PATIENT_CARE_SUMMARY\",\n \"QUALITY_MEASURES_SUMMARY\"\n ],\n \"principalOid\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"correlationId": "10c7b080-76f2-4aff-beeb-a2f7b4ca7a89",
"responses": [
{
"sequenceNumber": 0,
"correlationId": "4b0b3bdc-d007-4274-b1c7-f89fbb2fd775"
},
{
"sequenceNumber": 1,
"correlationId": "e82a9cfb-a6cd-4194-a0fd-9882b3a4e76b"
},
{
"sequenceNumber": 2,
"correlationId": "e5c3310a-6cb4-4755-a5c2-35b99d946181"
}
]
}{
"message": "<string>",
"_links": {},
"_embedded": {},
"logref": "<unknown>",
"path": "<unknown>"
}{
"correlationId": "10c7b080-76f2-4aff-beeb-a2f7b4ca7a89",
"responses": [
{
"sequenceNumber": 0,
"correlationId": "4b0b3bdc-d007-4274-b1c7-f89fbb2fd775"
},
{
"sequenceNumber": 1,
"correlationId": "e82a9cfb-a6cd-4194-a0fd-9882b3a4e76b"
},
{
"sequenceNumber": 2,
"correlationId": "e5c3310a-6cb4-4755-a5c2-35b99d946181"
}
]
}Authorizations
API Key
Body
application/json
Required array length:
1 - 2500 elementsShow child attributes
Show child attributes
Identifier which can be used to logically group requests together. Do not populate if you do not need to group requests together. Will default if not populated
Pattern:
[^<>"%;+@]*$Example:
"BATCH-123"
Directives which may influence how the data is processed. Applies to all requests in this panel.
Show child attributes
Show child attributes
Was this page helpful?