Insurance Data Object (Schemas)

📃

Note:

An empty string "" is considered a value and validation rules will apply (length/valid code/etc). Only null or missing elements will use default values.

Get Insurance Data Object

Query Parameter

FieldTypeCharacter LimitRequired/OptionalDescription
patientKeyString50RequiredUnique patient ID in Client system.

Response Object

FieldTypeCharacter LimitRequired/OptionalDescription
patientKeyString50RequiredUnique patient ID in Client system.
insuranceObject[InsuranceDataObject]RequiredObject containing patient's insurance information.

InsuranceDataObject

FieldTypeCharacter LimitRequired/OptionalDescription
policyHolderIdstring20RequiredInsurance policy holder ID
binString4-6RequiredInsurance BIN information. Minimum of 4 digits required.
groupIdString15OptionalInsurance group Id information.
pcnString10OptionalInsurance PCN information.
personCodeString3OptionalNumber 0 to 9.
relationshipCodeString1OptionalNumber 0 to 9. See relationship code table [below]
insuranceMemberIdString20OptionalHealthDyne Member ID

Relationship Codes

codeDescription
0Relation is NOT SPECIFIED
1Relation is CARDHOLDER
2Relation is SPOUSE
3Relation is CHILD
4Relation is OTHER DEPENDENT
5Relation is STUDENT DEPENDENT
6Relation is DISABLED DEPENDENT
7Relation is ADULT DEPENDENT
8Relation is SIGNIFICANT OTHER

Create Insurance Data Object

Request Object

FieldTypeCharacter LimitRequired/OptionalDescription
patientKeyString50RequiredUnique patient ID in Client system.
insuranceObject[CreateInsuranceDataObject ]RequiredObject containing patient's insurance information.

CreateInsuranceDataObject

FieldTypeCharacter LimitRequired/OptionalDescription
policyHolderIdstring20RequiredInsurance policy holder ID
binString4-6RequiredInsurance BIN information. Minimum of 4 digits required.
groupIdString15OptionalInsurance group Id information.
pcnString10OptionalInsurance PCN information.
personCodeString3OptionalNumber 0 to 9.
relationshipCodeString1OptionalNumber 0 to 9. See relationship code table below.
insuranceMemberIDString20OptionalHealthDyne Member ID

Response Object

FieldTypeCharacter LimitRequired/OptionalDescription
patientKeyString50RequiredUnique patient ID in Client system.
planNumberString40RequiredInsurance Plan Number
messageStringMaxRequiredPlan added to patient profile.

Delete Insurance Data Object

Query Parameter

ParameterTypeCharacter LimitRequired/OptionalDescription
patientKeyString50RequiredUnique patient ID in Client system.
planNumberString40RequiredInsurance Plan Number

Response Object

FieldTypeCharacter LimitRequired/OptionalDescription
patientKeyString50RequiredUnique patient ID in Client system.
planNumberString40RequiredInsurance Plan Number
messageStringMaxRequiredPatient Insurance plan number is inactivated successfully