📃
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.

Patient Request Data Object

Patient

Field	Type	Character Limit	Required/Optional	Description
patientKey	String	50	Required	Unique patient ID in Client system.
firstName	String	35	Required	Patient's first name.
lastName	String	35	Required	Patient's last name.
birthDate	DateTime	YYYY-MM-DD	Required	Patient's Date of Birth
gender	String	1	Required	Patient’s Gender – M, F or U
patientLanguage	String	3	Optional	Patient language must be ENG or SPA.
address	Object (address)		Required	Object containing patient’s address information. See Address table.
contact	Object (contact)		Required	Object containing patient’s contact information. See Contact table.
allergies	Array [allergies]		Required	Array containing patient’s allergy information. See the Allergies table for valid list of allergies.
externalMedications	Array [externalMedications]		Optional	Array containing patient’s external medications objects. List any external Medications the patient is taking for pharmacy to know if there is any drug interaction. If there are external medications, then ensure all the object elements are populated. See External Medications table.

Patient (Update Api)

Field	Type	Character Limit	Required/Optional	Description
patientKey	String	50	Required	Unique patient ID in Client system.
firstName	String	35	Required	Patient's first name.
lastName	String	35	Required	Patient's last name.
birthDate	DateTime	YYYY-MM-DD	Required	Patient's Date of Birth
gender	String	1	Required	Patient’s Gender – M, F or U
patientLanguage	String	3	Optional	Patient language must be ENG or SPA.
pregnancyIndicator	Bool		Optional	Patient's pregnancy state
address	Object (address)		Required	Object containing patient’s address information. See Address table.
contact	Object (contact)		Required	Object containing patient’s contact information. See Contact table.
allergies	Array [allergies]		Required	Array containing patient’s allergy information. See the Allergies table for valid list of allergies.
externalMedications	Array [externalMedications]		Optional	Array containing patient’s external medications objects. List any external Medications the patient is taking for pharmacy to know if there is any drug interaction. If there are external medications, then ensure all the object elements are populated. See External Medications table.
identification	Object (identification)		Optional	This object is used to update the Patient identification documents like driving license and its details in epost. See List of Identification Documents.

Address

Field	Type	Character Limit	Required/Optional	Description
addressType	String	15	Optional	Defines the type of address. If the filed is not sent by client, then defaults to HOME. Valid values include HOME, PRIMARY OFFICE, TEMPORARY, CORPORATE, ALTERNATE
line1	String	40	Required	Street Address
line2	String	40	Optional	Street Address
line3	String	40	Optional	Street Address
city	String	35	Required	City
state	String	2	Required	US State Abbreviation Code
zipCode	String	10	Required	Format NNNNN or NNNNN-NNNN
countryCode	String	2	Optional	ISO-3166 2 character country code. Defaults to US.
defaultAddress	Boolean		Optional	Values = true/false. When the address is to be used as the default address for patient, then populate True; otherwise default to FALSE.

Contact

Field	Type	Character Limit	Required/Optional	Description
contactType	String	15	Optional	Patient Contact – Phone, Home Phone, Day Phone, Work Phone, Fax Number, Cellular Number, Alternate
contactAddress	String	10	Required	Contact Details. For instance: Populate phone number if contact type is phone. Format:XXXXXXXXXX
emailAddress	String	60	Optional	Patient Email Address or Email Id. Note: This field will be visible only if value is not null.

*Required if the Contact object is being provided in the Patient object.

Allergies

Field	Type	Character Limit	Required/Optional	Description
allergies	Array	40	Required	Array of string. Character limit is for each string in Array. See valid allergy types below. The allergies field is required, if patient has no allergies pass "NO KNOWN".

Allergy Name	Allergy Class
ACE INHIBITORS	ACE INHIBITORS
ACETAMINOPHEN	ACETAMINOPHEN
Amoxicillin	Penicillins
Aspirin	Salicylates
Atenolol	BETA ADRENERGIC BLOCKERS
Atorvastatin	STATINS
Benazepril	ACE INHIBITORS
BETA ADRENERGIC BLOCKERS	BETA ADRENERGIC BLOCKERS
Cephalosporins	Cephalosporins
Ciprofloxacin	QUINOLONES
Codeine	Morphine and Related
Demerol	MEPERIDINE AND RELATED
Erythromycin	Macrolides and Ketolides
Fosinopril	ACE INHIBITORS
IBUPROFEN	NSAIDS
IODIDES	IODINATED CONTRAST MEDIA
IODINATED CONTRAST MEDIA	IODINATED CONTRAST MEDIA
IODINATED DIAGNOSTIC AGENTS	IODINATED CONTRAST MEDIA
Levofloxacin	QUINOLONES
Lisinopril	ACE INHIBITORS
Macrolides and Ketolides	Macrolides and Ketolides
MEPERIDINE AND RELATED	MEPERIDINE AND RELATED
Metoprolol	BETA ADRENERGIC BLOCKERS
MISC. SULFONAMIDE CONTAINING COMPOUNDS	MISC. SULFONAMIDE CONTAINING COMPOUNDS
Morphine and Related	Morphine and Related
No Known	No Known Drug Allergy
No Known Drug Allergy	No Known Drug Allergy
NSAIDS	NSAIDS
Penicillins	Penicillins
QUINOLONES	QUINOLONES
Rosuvastatin	STATINS
Salicylates	Salicylates
SHELLFISH-DERIVED PRODUCTS	SHELLFISH-DERIVED PRODUCTS
Simvastatin	STATINS
STATINS	STATINS
Sulfa	Sulfa Antibiotics
Sulfa Antibiotics	Sulfa Antibiotics
Tetracyclines	Tetracyclines & Related
Tetracyclines & Related	Tetracyclines & Related

📃
Additional Allergy Information
Allergy information not matching the defined allergy list will still be accepted. However the information will be added in the HealthDyne system under the "notes" section of the Patient's profile for pharmacist to review. Each non-defined allergy list entry has a 40 character limit.

External Medications

Field	Type	Character Limit	Required/Optional	Description
ndc	String	11	Required*	NDC of the medication
startDate	DateTime	YYYY-MM-DD	Optional	Date when medication was started
endDate	DateTime	YYYY-MM-DD	Optional	Date when medication was ended

*NDC is required if the External Medications object is being provided in the Patient object.

Identification

Field	Type	Character Limit	Required/Optional	Description
patientId	String	60	Required*	Unique Id of the Identity Document.
patientIdCode	String	03	Required*	Code to identify the type of identity document. For example: 02 refers to Driver's license. See List of Identification Documents .
patientIdExpiration	DateOnly?	YYYY-MM-DD	Optional	Date when the identity document will be expired / invalid.

List of Identification Documents

Patient Id Code	Description
01	SOCIAL SECURITY NUMBER
02	DRIVERS LICENSE NUMBER
03	U.S. MILITARY ID
04	Non-SSN based ID
06	Medicaid ID assigned by State
07	State Issued ID
08	Passport ID
09	Medicaid HIC#
10	Employer Assigned ID
11	Payer/PBM Assigned ID
12	Alien Number ID
13	Student Visa ID
14	Indian Tribal ID
1J	Facility ID
99	OTHER
EA	Medical Record ID(EHR)

GET Patient Request

Query Parameter

Field	Character Limit	Type	Required/Optional	Description
patientKey	50	String	Required	Unique patient ID in Client system.

Response Object

Field	Type	Character Limit	Required/Optional	Description
patientKey	String	50	Required	Unique patient ID in Client system.
firstName	String	35	Required	Patient's first name.
lastName	String	35	Required	Patient's last name.
gender	String	1	Required	Patient’s Gender – M, F or U
epostPatientNumber	Integer		Optional	Patient's ePost Number. Note: This field will only be visible for DTC client.
patientLanguage	String	3	Required	Patient language must be ENG or SPA.
birthDate	DateTime	YYYY-MM-DD	Required	Patient's Date of Birth
healthCondition	Array		Optional	Patient's health condition.
address	Object (address)		Required	Object containing patient’s address information. See Address table.
contact	Object (contact)		Required	Object containing patient’s contact information. See Contact table.
externalMedications	Array [externalMedications]		Optional	Array containing patient’s external medications objects. List any external Medications the patient is taking for pharmacy to know if there is any drug interaction. If there are external medications, then ensure all the object elements are populated. See External Medications table.
identification	Object (identification)		Optional	This object is used to update the Patient identification documents like driving license and its details in epost. See List of Identification Documents.
pregnancyIndicator	String	1	Required	Patient's pregnancy status.
allergies	Array [allergies]		Optional	Array containing patient’s allergy information. See the Allergies table for valid list of allergies.

Identification

Field	Type	Character Limit	Required/Optional	Description
patientId	String	60	Required	Unique Id of the Identity Document.
patientIdCode	String	03	Required	Code to identify the type of identity document. For example: 02 refers to Driver's license. See List of Identification Documents .
patientIdExpiration	DateOnly?	YYYY-MM-DD	Optional	Date when the identity document will be expired / invalid.

List of Identification Documents

Patient Id Code	Description
01	SOCIAL SECURITY NUMBER
02	DRIVERS LICENSE NUMBER
03	U.S. MILITARY ID
04	Non-SSN based ID
06	Medicaid ID assigned by State
07	State Issued ID
08	Passport ID
09	Medicaid HIC#
10	Employer Assigned ID
11	Payer/PBM Assigned ID
12	Alien Number ID
13	Student Visa ID
14	Indian Tribal ID
1J	Facility ID
99	OTHER
EA	Medical Record ID(EHR)

Find Patient Request

Query Parameter

Field	Type	Character Limit	Required/Optional	Description
firstName	String	35	Required	Patient's first name.
lastName	String	35	Required	Patient's last name.
birthDate	DateTime	YYYY-MM-DD	Required	Patient's Date of Birth
zipCode	String	10	Required	Format NNNNN or NNNNN-NNNN

Response Object

Field	Type	Character Limit	Required/Optional	Description
patientKey	Array		Required	Array of patientKey(s) (Unique patient ID in Client system.).
firstName	String	35	Required	Patient's first name.
lastName	String	35	Required	Patient's last name.
birthDate	DateTime	YYYY-MM-DD	Required	Patient's Date of Birth
zipCode	String	10	Required	Format NNNNN or NNNNN-NNNN

Get Patient Scripts/Prescriptions Request

Query Parameter

Field	Type	Character Limit	Required/Optional	Description
patientKey	String	50	Required	Unique patient ID in Client system.

Response Object

Field	Type	Character Limit	Required/Optional	Description
scriptKeys	Array	50 per value	Required	Array of scriptKey(s) associated to Patient.

Create Patient Request

Request Object

Field	Type	Character Limit	Required/Optional	Description
patient	Object (patient)		Required	Object containing patient’s personal information.

Response Object

Field	Type	Character Limit	Description
patientKey	String	50	Unique patient ID in Client system.
message	String	max	Status messages string.
epostPatientNumber	Integer		Unique patient number from ePost. Note: This field will appear in response only if EPostRxPatientNumberEnabled flag for client is enabled.

Update Patient Request

Request Object

Field	Type	Character Limit	Required/Optional	Description
patient	Object (patient)		Required	Object containing patient’s personal information.

Response Object

Field	Type	Character Limit	Description
patientKey	String	50	Unique patient ID in Client system.
message	String	max	Status messages string.
epostPatientNumber	Integer		Unique patient number from ePost. Note: This field will appear in response only if EPostRxPatientNumberEnabled flag for client is enabled.

Patient Payment Cards Objects

Get Patient Payment Cards Request

Response Object

Field	Type	Description
patientKey	String	Unique patient ID in Client system.
cards	Array	Cards info object

cards Object

Field	Type	Description
cardType	String	Indicates the type of card (e.g., Visa, MasterCard, Amex) represented by a numeric code.
cardNumber	Array	The masked payment card number, showing only the last four digits for security.
cardHolderFirstName	String	First name of the cardholder as it appears on the card.
cardHolderLastName	String	Last name of the cardholder as it appears on the card.
cardExpireMonth	Integer	The expiration month of the card.
cardExpireYear	Integer	The expiration year of the card.
defaultCard	Bool	Indicates whether this card is the primary/default card on file (true/false).
cardSequenceNumber	String	Payment Card Sequence Number
cardStatus	String	Payment Card Status

Add Patient Payment Cards Request

The Add Patient Payment Card endpoint accepts a request payload containing patientKey and returnUrl. The returnUrl is supplied by the client and specifies the callback destination to which the patient is redirected after completing the payment card form.

Request Object

Field	Type	Character Limit	Description
patientKey	String	50	Unique patient ID in Client system.
returnUrl	String		This is the callback URL that the patient will be directed to after adding the payment card

Response Object

Field	Type	Character Limit	Description
returnUrl	String		This URL is used by the client to redirect the patient to the payment card entry page.

Update Patient Payment Cards Request

Request Object

Field	Type	Description
patientKey	String	Unique patient ID in Client system.
cardSequenceNumber	String	A unique sequence or reference number associated with the card. Typically used to identify the card in external or internal systems.
expirationMonth	Integer	The month (1–12) when the card expires.
expirationYear	Integer	The 4-digit year when the card expires.
cardFirstName	String	The cardholder’s first name as it appears on the card.
cardMiddleName	String	The cardholder’s middle name or initial, if applicable.
cardLastName	String	The cardholder’s last name as it appears on the card.

Response Object

Field	Type	Description
patientKey	String	Unique patient ID in Client system.
cardSequenceNumber	String	A unique sequence or reference number associated with the card. Typically used to identify the card in external or internal systems.
message	String	Message or status details related to the request.

Deactivate Patient Payment Cards Request

Request Object

Type	Description
String	Unique patient ID in Client system.
String	A unique sequence or reference number associated with the card. Typically used to identify the card in external or internal systems.

Response Object

Field	Type	Description
patientKey	String	Unique patient ID in Client system.
cardSequenceNumber	String	A unique sequence or reference number associated with the card. Typically used to identify the card in external or internal systems.
message	String	Message or status details related to the request.