Nursys E-Notify File and API Specifications v2.1.8 PDF
Nursys E-Notify File and API Specifications v2.1.8 PDF
The information contained in this document is provided for informational purposes only. NCSBN,
specifically disclaims all warranties, express or limited, including, but not limited, to the implied
warranties of merchantability and fitness for a particular purpose, except as provided for in a separate
software license agreement.
1.3.1 NCSBN ID
Organizations looking to use the API to consume the NCSBN ID for each nurse can use the API to enroll a
license to their Nursys e-Notify Nurse List (Manage Nurse List methods) and then use the Submit Nurse
Lookup/Retrieve Nurse Lookup methods to consume the NCSBN ID for that enrolled licensee.
Note: By supplying a cell phone number and enabling license expiration reminders for a nurse,
the institution is acknowledging that text message reminders will be sent to the number
provided and the recipient may be charged fees by their provider.
9. City (City)
a. The city of the nurse’s employment address.
b. If this value is missing or too long, the following error message will be returned: 11 -
Invalid or missing City. This field is required and must be 50 or fewer characters in
length.
Note: Nursys e-Notify requires this information for record verification purposes only.
Note: Nursys e-Notify requires this information for record verification purposes only.
Note for API Users: Some API users have been unable to submit requests without specifying a
hospital practice setting value, even though their institution type is not set to “Hospital”. In
these cases the recommendation is to set the hospital practice setting value to “-1” (Blank).
Note: By supplying a cell phone number and enabling license expiration reminders for a nurse,
the institution is acknowledging that text message reminders will be sent to the number
provided and the recipient may be charged fees by their provider.
Note: Nursys e-Notify users with administrative rights may review, add, edit, and remove
locations by signing into Nursys e-Notify and navigating to Settings > Location Information.
There they can also find information about location codes and default locations.
1. Uploading the file. In this step, the institution selects the Nursys e-Notify file they would like to
upload. Here the file type, name, and contents are validated per the rules outlined in section
2.2.
2. Reviewing and editing the file records. In this step the institution reviews all of the records
contained in their Nursys e-Notify file. Any validation errors that were found are displayed. The
institution can review and resolve each of the validation errors. Any records with unresolved
validation errors are automatically excluded from further processing.
3. Submitting the file. Each nurse record in the file is individually processed. The appropriate adds,
updates, and removals are made to the list of nurses the institution has enrolled in Nursys e-
Notify.
Only one Nursys e-Notify file may be uploaded by an institution at a time. All steps must be completed
before a new file can be uploaded. The institution also has the option to entirely cancel a file upload at
any point during the process.
Click on the nurse’s name to review individual details such as NCSBN ID, license number, expiration date,
license status, discipline/final orders history, and authorization to practice.
Here is a sample of some of the information available from the Summary Report in Microsoft Excel
(XLSX) format.
For more information about Web services, please navigate to the following site:
http://www.w3schools.com/webservices/default.asp.
3.1.2 HTTPS
HTTPS is an industry-standard mechanism for securely transmitting data. This technology ensures both
the client request message and the Nursys e-Notify response details are securely communicated. Nursys
e-Notify requires connecting using the Transport Layer Security (TLS) version 1.2 protocol.
3.1.3 Authentication
In order to use the Nursys e-Notify API, an institution must provide valid credentials to be authenticated.
Each institution wishing to use the Nursys e-Notify API will have one account consisting of a username
and password. Please contact Nursys e-Notify customer service (see section 1.4) to request API
credentials. Only one username and password are required for each institution.
Once received, your credentials can be managed by your institution’s administrator. Administrators can
view the API username, change the API password, and view the API URL. API passwords must be
updated every 90 days.
Note: The communication of authentication information is secure since the Nursys e-Notify API requires
HTTPS. However, it is the responsibility of each institution to protect the credentials stored in their
infrastructure according to information security best practices.
1. Credentials Fault: The specified request did not contain valid credential information based on
authentication validation architecture.
2. Services Fault: The request results in a processing error, either specific to the business rules
defined for the Nursys e-Notify API or an unexpected error in the processing of a transaction.
3.2 Methods
The Nursys e-Notify API exposes four methods. The first method is for adding, updating, and removing
nurses from an institution’s nurse list. The second method is for changing the institution’s API password.
The third and fourth methods return extended license information for a nurse enrolled in an institution’s
nurse list.
ManageNurseListRequest
Element Name Data Type Length Usage Description
<Credentials> Required API authentication credentials.
<TransactionID> String 50 Required Transaction identifier.
<Nurses> Collection Required Collection of nurse objects.
Credentials
Element Name Data Type Length Usage Description
<Username> String 50 Required Authentication login.
<Password> String 50 Required Authentication password.
TransactionID
Element Name Data Type Length Usage Description
<TransactionID> String 50 Required Transaction identifier.
Nurses
Element Name Data Type Length Usage Description
<Nurses> Collection Required Collection of nurse objects.
Nurse (please refer to section 2.2.2 for field definitions and processing rules)
Element Name Data Type Usage Length Description
<SubmissionActionCode> String Required 1 Submission action code
<Jurisdiction> String Required 4 State board of nursing.
<LicenseNumber> String Required 15 License number.
<LicenseType> String Required 4 License type.
<Email> String Optional 50 E-mail address.
<CellPhoneNumber> String Optional 10 Cell phone number.
<Address1> String Required 50 Address line 1.
<Address2> String Optional 50 Address line 2.
<City> String Required 50 City.
<State> String Required 2 State.
<Zip> String Required 10 Zip code.
<LastFourSSN> String Required 4 Last four digits of social security number.
<BirthMonth> Integer Optional 2 Unused/ignored
<BirthYear> Integer Required 4 Birth year.
<HospitalPracticeSetting> Integer Required 2 Hospital practice setting.
< HospitalPracticeSetting
String Optional 50 Hospital practice setting (other).
Other>
<HireDate> Date Optional Unused/ignored
License and state licensure action notifications
<NotificationsEnabled> String Required 1
enabled.
<RemindersEnabled> String Required 1 License expiration reminders enabled.
<ReleasedForDiscipline> String Optional 1 Unused/ignored
<ReleasedComments> String Optional 100 Unused/ignored
<LocationList> String Optional 100 Pipe delimited list of location codes.
Client-provided identifier echoed back as part of the
<RecordID> String Optional 50
response.
Note: By supplying a cell phone number and enabling license expiration reminders for a nurse, the
institution is acknowledging that text message reminders will be sent to the number provided and the
recipient may be charged fees by their provider.
<?xml version="1.0"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<ManageNurseListRequest xmlns="http://com.nursys.services.ServiceModel/2012/eNotifyService">
<Credentials xmlns:a="http://com.nursys.services.ServiceModel/2012/Credentials"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:Username>MyAPIUsername</a:Username>
<a:Password>MyAPIPassword#1</a:Password>
</Credentials>
<Nurses xmlns:a="http://com.nursys.services.ServiceModel/2012/eNotify"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:Nurse>
<a:SubmissionActionCode>A</a:SubmissionActionCode>
<a:Jurisdiction>IL</a:Jurisdiction>
<a:LicenseNumber>00000001</a:LicenseNumber>
<a:LicenseType>RN</a:LicenseType>
<a:Email>[email protected]</a:Email>
<a:CellPhoneNumber>3125555555</a:CellPhoneNumber>
<a:Address1>123 Fake Street</a:Address1>
<a:Address2>Suite 100</a:Address2>
<a:City>Chicago</a:City>
<a:State>IL</a:State>
<a:Zip>60601</a:Zip>
<a:LastFourSSN>9999</a:LastFourSSN>
<a:BirthYear>1950</a:BirthYear>
<a:HospitalPracticeSetting>21</a:HospitalPracticeSetting>
<a:HospitalPracticeSettingOther>Lorem Ipsum</a:HospitalPracticeSettingOther>
<a:NotificationsEnabled>Y</a:NotificationsEnabled>
<a:RemindersEnabled>Y</a:RemindersEnabled>
<a:LocationList>001</a:LocationList>
<a:RecordID>12345</a:RecordID>
</a:Nurse>
</Nurses>
<TransactionID>6f5c1159-bb8c-454d-b989-06cfd4a2ef9b</TransactionID>
</ManageNurseListRequest>
</s:Body>
</s:Envelope>
MangeNurseListResponse
Element Name Data Type Length Usage Description
<Transaction> Required Information about the API request and
response.
<NurseResponses> Collection Required Collection of nurse response objects.
Transaction
Element Name Data Type Length Usage Description
<TransactionID> String 50 Required Transaction identifier supplied in the
request.
<TransactionDate> Date Required System date and time when the request was
processed.
<TransactionComment> String 5000 Optional System provided comments regarding the
processing of the request.
<TransactionSuccessFlag> Boolean Required True or False indicator if the request was
successfully processed or not.
<TransactionErrors> Collection Optional A collection of system errors that may have
occurred during the processing of the
request.
TransactionError
Element Name Data Type Length Usage Description
<ErrorID> Integer 10 Required System assigned processing error identifier.
<ErrorMessage> String 5000 Required System provided processing error message.
NurseResponses
Element Name Data Type Length Usage Description
<NurseResponses> Collection Required Collection of nurse response objects.
NurseResponse (please refer to section 3.3.4 for the Nurse object definition)
Element Name Data Type Usage Length Description
<Nurse> Required Nurse sent via request.
True or False indicator if the Nurse was successfully
<SuccessFlag> Boolean Required
added/updated/removed.
A collection of validation errors that may have
<Errors> Collection Optional
occurred during the processing of the Nurse.
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<ManageNurseListResponse xmlns="http://com.nursys.services.ServiceModel/2012/eNotifyService">
<NurseResponses xmlns:a="http://com.nursys.services.ServiceModel/2012/eNotify"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:NurseResponse>
<a:SuccessFlag>true</a:SuccessFlag>
<a:Errors/>
<a:Nurse>
<a:SubmissionActionCode>A</a:SubmissionActionCode>
<a:Jurisdiction>IL</a:Jurisdiction>
<a:LicenseNumber>00000001</a:LicenseNumber>
<a:LicenseType>RN</a:LicenseType>
<a:Email>[email protected]</a:Email>
<a:CellPhoneNumber>3125555555</a:CellPhoneNumber>
<a:Address1>123 FAKE STREET</a:Address1>
<a:Address2>SUITE 100</a:Address2>
<a:City>CHICAGO</a:City>
<a:State>IL</a:State>
<a:Zip>60601</a:Zip>
<a:LastFourSSN/>
<a:BirthMonth>-1</a:BirthMonth>
<a:BirthYear>-1</a:BirthYear>
<a:HospitalPracticeSetting>21</a:HospitalPracticeSetting>
<a:HospitalPracticeSettingOther>LOREM IPSUM</a:HospitalPracticeSettingOther>
<a:NotificationsEnabled>Y</a:NotificationsEnabled>
<a:RemindersEnabled>Y</a:RemindersEnabled>
<a:ReleasedForDiscipline/>
<a:ReleasedComments/>
<a:RecordID>12345</a:RecordID>
<a:LocationList>|001</a:LocationList>
<a:HireDate>0001-01-01T00:00:00</a:HireDate>
</a:Nurse>
</a:NurseResponse>
</NurseResponses>
<Transaction xmlns:a="http://com.nursys.services.ServiceModel/2012/Transaction"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:TransactionID>6f5c1159-bb8c-454d-b989-06cfd4a2ef9b</a:TransactionID>
<a:TransactionDate>2018-01-01T15:56:22.8278625-06:00</a:TransactionDate>
<a:TransactionComment/>
<a:TransactionSuccessFlag>true</a:TransactionSuccessFlag>
<a:TransactionErrors/>
</Transaction>
</ManageNurseListResponse>
</s:Body>
</s:Envelope>
ChangePasswordRequest
Element Name Data Type Length Usage Description
<Credentials> Required API authentication credentials.
<TransactionID> String 50 Required Transaction identifier.
<NewPassword> String 50 Required New API authentication password.
Credentials
Element Name Data Type Length Usage Description
<Username> String 50 Required Authentication login.
<Password> String 50 Required Authentication password.
TransactionID
Element Name Data Type Length Usage Description
<TransactionID> String 50 Required Transaction identifier.
As long as these rules are met the password can contain any combination of mixed case letters,
numbers, and punctuation characters.
NewPassword
Element Name Data Type Length Usage Description
<NewPassword> String 50 Required New API authentication password.
<?xml version="1.0"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<ChangePasswordRequest xmlns="http://com.nursys.services.ServiceModel/2012/eNotifyService">
<Credentials xmlns:a="http://com.nursys.services.ServiceModel/2012/Credentials"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:Username>MyAPIUsername</a:Username>
<a:Password>MyAPIPassword#1</a:Password>
</Credentials>
<NewPassword>MyAPIPassword#2</NewPassword>
<TransactionID>6f5c1159-bb8c-454d-b989-06cfd4a2ef9b</TransactionID>
</ChangePasswordRequest>
</s:Body>
</s:Envelope>
ChangePasswordResponse
Element Name Data Type Length Usage Description
<Transaction> Required Information about the API request and
response.
Transaction
Element Name Data Type Length Usage Description
<TransactionID> String 50 Required Transaction identifier supplied in the
request.
<TransactionDate> Date Required System date and time when the request was
processed.
<TransactionComment> String 5000 Optional System provided comments regarding the
processing of the request.
<TransactionSuccessFlag> Boolean Required True or False indicator if the request was
successfully processed or not.
<TransactionErrors> Collection Optional A collection of system errors that may have
occurred during the processing of the
request.
TransactionError
Element Name Data Type Length Usage Description
<ErrorID> Integer 4 Required System assigned processing error identifier.
<ErrorMessage> String 5000 Required System provided processing error message.
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<ChangePasswordResponse xmlns="http://com.nursys.services.ServiceModel/2012/eNotifyService">
<Transaction xmlns:a="http://com.nursys.services.ServiceModel/2012/Transaction"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:TransactionID>6f5c1159-bb8c-454d-b989-06cfd4a2ef9b</a:TransactionID>
<a:TransactionDate>2018-01-01T16:05:35.3251067-06:00</a:TransactionDate>
<a:TransactionComment/>
<a:TransactionSuccessFlag>true</a:TransactionSuccessFlag>
<a:TransactionErrors/>
</Transaction>
</ChangePasswordResponse>
</s:Body>
</s:Envelope>
NurseLookupRequest
Element Name Data Type Length Usage Description
<Credentials> Required API authentication credentials.
<LicenseRequests> Collection Required Collection of license request objects.
Credentials
Element Name Data Type Length Usage Description
<Username> String 50 Required Authentication login.
<Password> String 50 Required Authentication password.
LicenseRequests
Element Name Data Type Length Usage Description
<LicenseRequests> Collection Required Collection of license request objects.
LicenseRequest
Element Name Data Type Usage Length Description
<LicenseNumber> String Required 15 License number.
State board of nursing. Please see the appendix for a
<Jurisdiction> String Required 4
list of valid values.
License type. Please see the appendix for a list of valid
<LicenseType> String Required 4
values.
Client-provided identifier echoed back as part of the
<RecordID> String Optional 50
response.
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<NurseLookupRequest xmlns="http://com.nursys.services.ServiceModel/2012/eNotifyService">
<Credentials xmlns:a="http://com.nursys.services.ServiceModel/2012/Credentials"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:Username>MyAPIUsername</a:Username>
<a:Password>MyAPIPassword#1</a:Password>
</Credentials>
<LicenseRequests xmlns:a="http://com.nursys.services.ServiceModel/2012/eNotify"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:LicenseRequest>
<a:LicenseNumber>00000001</a:LicenseNumber>
<a:Jurisdiction>IL</a:Jurisdiction>
<a:LicenseType>RN</a:LicenseType>
<a:RecordID>12345</a:RecordID>
</a:LicenseRequest>
</LicenseRequests>
</NurseLookupRequest>
</s:Body>
</s:Envelope>
SubmitNurseLookupResponse
Element Name Data Type Length Usage Description
<Transaction> Required Information about the API request and
response.
Note: This TransactionID will be used as an input into the RetrieveNurseLookup method to receive the
lookup results.
Transaction
Element Name Data Type Length Usage Description
<TransactionID> String 50 Required Unique transaction identifier. Used as an
input for RetrieveNurseLookup.
<TransactionDate> Date Required System date and time when the request was
processed.
<TransactionComment> String 5000 Optional System provided comments regarding the
processing of the request.
<TransactionSuccessFlag> Boolean Required True or False indicator if the request was
successfully processed or not.
<TransactionErrors> Collection Optional A collection of system errors that may have
occurred during the processing of the
request.
TransactionError
Element Name Data Type Length Usage Description
<ErrorID> Integer 10 Required System assigned processing error identifier.
<ErrorMessage> String 5000 Required System provided processing error message.
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<SubmitNurseLookupResponse
xmlns="http://com.nursys.services.ServiceModel/2012/eNotifyService">
<Transaction xmlns:a="http://com.nursys.services.ServiceModel/2012/Transaction"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:TransactionID>001ea1b3-6a20-40c6-96d9-5dc2467387c9</a:TransactionID>
<a:TransactionDate>2018-03-02T15:18:15.4895367-06:00</a:TransactionDate>
<a:TransactionComment/>
<a:TransactionSuccessFlag>true</a:TransactionSuccessFlag>
<a:TransactionErrors/>
</Transaction>
</SubmitNurseLookupResponse>
</s:Body>
</s:Envelope>
RetrieveNurseLookupRequest
Element Name Data Type Length Usage Description
<Credentials> Required API authentication credentials.
<TransactionID> String 50 Required Unique transaction identifier. Output by the
SubmitNurseLookup method.
Credentials
Element Name Data Type Length Usage Description
<Username> String 50 Required Authentication login.
<Password> String 50 Required Authentication password.
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<RetrieveNurseLookupRequest
xmlns="http://com.nursys.services.ServiceModel/2012/eNotifyService">
<Credentials xmlns:a="http://com.nursys.services.ServiceModel/2012/Credentials"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:Username>MyAPIUsername</a:Username>
<a:Password>MyAPIPassword#1</a:Password>
</Credentials>
<TransactionID>001ea1b3-6a20-40c6-96d9-5dc2467387c9</TransactionID>
</RetrieveNurseLookupRequest>
</s:Body>
</s:Envelope>
If the API has not finished processing the submitted request, then the ProcessingCompleteFlag will be
false and the NurseLicenseResponses collection will be empty. If the API has finished processing the
submitted request then the ProcessingCompleteFlag will be true and the NurseLicenseResponses
collection will be populated.
NurseLookupResponse
Element Name Data Type Length Usage Description
<NurseLicenseResponses> Collection Required Collection of license response objects.
<ProcessingCompleteFlag> Boolean Required Indicates if the API has finished processing
the request.
<Transaction> Required
LicenseResponses
Element Name Data Type Length Usage Description
<LicenseResponses> Collection Required Collection of license response objects.
LicenseResponse (please refer to section 3.7.3 for the LicenseRequest object definition)
Element Name Data Type Usage Length Description
<SuccessFlag> Boolean Required True or False indicator if the lookup was successful.
A collection of errors that may have occurred during
<Errors> Collection Optional
the processing of the license request.
<LicenseRequest> Required License sent via request.
NCSBN ID is the public, globally unique identifier for
<NCSBNID> Integer Optional 10
all nurses from participating boards of nursing.
A collection of notification messages regarding the
<Messages> Collection Optional nurse. It is vital to review these messages as they
may contain important information.
<NurseLicenses> Collection Optional A collection of licenses.
A collection of RN authorization to practice
<RNAuthorizationToPractices> Collection Required
information for each state.
A collection of PN authorization to practice
<PNAuthorizationToPractices> Collection Required
information for each state.
NurseLicense
Element Name Data Type Usage Length Description
State board of nursing. See appendix for a list of valid
<Jurisdiction> String Required 4
values.
<LicenseNumber> String Required 15 License number.
<LicenseType> String Required 4 License type. See appendix for a list of valid values.
<FirstName> String Required 50 Licensee first name.
<LastName> String Required 50 Licensee last name.
Nurse Licensure Compact (NLC/ENLC) status of the
<CompactStatus> String Optional 50 license. Please visit nursys.com for more information
about the NLC/ENLC.
<Active> String Optional 50 Active status for the license.
<OriginalIssueDate> Date Optional Original issue date for the license.
<ExpirationDate> Date Optional Expiration date for the license.
<LicenseStatus> String Optional 500 Current status of the license.
A collection of notification messages regarding the
<Messages> Collection Optional license. It is vital to review these messages as they
may contain important license information.
Messages
Element Name Data Type Length Usage Description
<Message> String 5000 Required A notification message regarding the nurse
or license. It is vital to review this message
as it may contain important information.
Error
Element Name Data Type Length Usage Description
<ErrorID> Integer 10 Required System assigned validation error identifier.
<ErrorMessage> String 5000 Required System provided validation error message.
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<NurseLookupResponse
xmlns="http://com.nursys.services.ServiceModel/2012/eNotifyService">
<NurseLicenseResponses
xmlns:a="http://com.nursys.services.ServiceModel/2012/eNotify"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:NurseLicenseResponse>
<a:SuccessFlag>true</a:SuccessFlag>
<a:Errors/>
<a:LicenseRequest>
<a:LicenseNumber>00000001</a:LicenseNumber>
<a:Jurisdiction>IL</a:Jurisdiction>
<a:LicenseType>RN</a:LicenseType>
<a:RecordID>12345</a:RecordID>
</a:LicenseRequest>
<a:NCSBNID>24680</a:NCSBNID>
<a:Messages/>
<a:NurseLicenses>
<a:NurseLicense>
<a:Jurisdiction>IL</a:Jurisdiction>
<a:LicenseNumber>00000001</a:LicenseNumber>
<a:LicenseType>RN</a:LicenseType>
<a:FirstName>JANE</a:FirstName>
<a:LastName>PUBLIC</a:LastName>
<a:CompactStatus>N/A</a:CompactStatus>
<a:Active>YES</a:Active>
<a:OriginalIssueDate>2000-01-01T00:00:00</a:OriginalIssueDate>
<a:ExpirationDate>2025-12-31T00:00:00</a:ExpirationDate>
<a:LicenseStatus>UNENCUMBERED</a:LicenseStatus>
<a:Messages/>
</a:NurseLicense>
</a:NurseLicenses>
<a:RNAuthorizationToPractices>
<a:AuthorizationToPractice>
<a:Jurisdiction i:nil="true"/>
<a:StateAbbreviation>AK</a:StateAbbreviation>
<a:StateDescription>ALASKA</a:StateDescription>
<a:AuthorizationToPracticeCode>N</a:AuthorizationToPracticeCode>
<a:AuthorizationToPracticeDescription>NO AUTHORIZATION TO
PRACTICE</a:AuthorizationToPracticeDescription>
<a:AuthorizationToPracticeNarrative>ALASKA: THIS NURSE DOES NOT HAVE
AUTHORIZATION TO PRACTICE AS AN RN IN ALASKA. THIS IS BASED ON INFORMATION PROVIDED TO
NURSYS BY THE ALASKA BOARD OF NURSING.</a:AuthorizationToPracticeNarrative>
</a:AuthorizationToPractice>
<a:AuthorizationToPractice>
<a:Jurisdiction i:nil="true"/>
<a:StateAbbreviation>IL</a:StateAbbreviation>
<a:StateDescription>ILLINOIS</a:StateDescription>
<a:AuthorizationToPracticeCode>Y</a:AuthorizationToPracticeCode>
<a:AuthorizationToPracticeDescription>AUTHORIZATION TO
PRACTICE</a:AuthorizationToPracticeDescription>
<a:AuthorizationToPracticeNarrative>ILLINOIS: THIS NURSE HAS
AUTHORIZATION TO PRACTICE AS AN RN IN ILLINOIS BECAUSE THEY HOLD AN RN LICENSE FROM
NotificationLookupRequest
Element Name Data Type Length Usage Description
<Credentials> Required API authentication credentials.
<TransactionID> String 50 Required Transaction identifier.
<StartDate> Date Required The method will return licenses with a
license status change on or after this date.
<EndDate> Date Required The method will return licenses with a
license status change on or before this date.
Credentials
Element Name Data Type Length Usage Description
<Username> String 50 Required Authentication login.
<Password> String 50 Required Authentication password.
TransactionID
Element Name Data Type Length Usage Description
<TransactionID> String 50 Required Transaction identifier.
<?xml version="1.0"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<NotificationLookupRequest
xmlns="http://com.nursys.services.ServiceModel/2012/eNotifyService">
<Credentials xmlns:a="http://com.nursys.services.ServiceModel/2012/Credentials"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:Username>MyAPIUsername</a:Username>
<a:Password>MyAPIPassword#1</a:Password>
</Credentials>
<EndDate>2018-01-31T00:00:00</EndDate>
<StartDate>2018-01-01T00:00:00</StartDate>
<TransactionID>12345</TransactionID>
</NotificationLookupRequest>
</s:Body>
</s:Envelope>
NotificationLookupResponse
Element Name Data Type Length Usage Description
<Transaction> Required Transaction header.
<NotificationLookupFlag> Boolean Required Indicates if any status changes occurred
during the specified date range.
<NotificationResponses> Collection Required Collection of notification response objects.
Transaction
Element Name Data Type Length Usage Description
<TransactionID> String 50 Required Transaction identifier supplied in the
request.
<TransactionDate> Date Required System date and time when the request was
processed.
<TransactionComment> String 5000 Optional System provided comments regarding the
processing of the request.
<TransactionSuccessFlag> Boolean Required True or False indicator if the request was
successfully processed or not.
<TransactionErrors> Collection Optional A collection of system errors that may have
occurred during the processing of the
request.
NotificationResponses
Element Name Data Type Length Usage Description
<NotificationResponses> Collection Required Collection of license response objects.
NotificationResponse
Element Name Data Type Usage Length Description
<NotificationDate> Date Required Date the status change was reported.
State board of nursing. See appendix for a list of
<Jurisdiction> String Required 4
valid values.
<LicenseType> String Required 4 License type. See appendix for a list of valid values.
<LicenseNumber> String Required 15 License number.
<LastName> String Required 50 Licensee last name.
<FirstName> String Required 50 Licensee first name.
<RecordID> String Optional 50 Client-provided identifier.
<LicenseStatusChange> String Optional 500 License status changes affecting the enrolled license.
State licensure action status changes affecting the
<DisciplineStatusChange> String Optional 500
enrolled license.
State licensure action status changes affecting
<DisciplineStatusChangeOther> String Optional 500 licenses the nurse may hold that may not be
enrolled.
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<NotificationLookupResponse
xmlns="http://com.nursys.services.ServiceModel/2012/eNotifyService">
<NotificationLookupFlag>true</NotificationLookupFlag>
<NotificationResponses xmlns:a="http://com.nursys.services.ServiceModel/2012/eNotify"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:NotificationResponse>
<a:Jurisdiction>IL</a:Jurisdiction>
<a:LicenseNumber>00000001</a:LicenseNumber>
<a:LicenseType>RN</a:LicenseType>
<a:FirstName>JANE</a:FirstName>
<a:LastName>PUBLIC</a:LastName>
<a:RecordID/>
<a:LicenseStatusChange>--</a:LicenseStatusChange>
<a:NotificationDate>2018-01-01T00:00:00</a:NotificationDate>
<a:DisciplineStatusChange>Discipline added</a:DisciplineStatusChange>
<a:DisciplineStatusChangeOther>--</a:DisciplineStatusChangeOther>
</a:NotificationResponse>
<a:NotificationResponse>
<a:Jurisdiction>IL</a:Jurisdiction>
<a:LicenseNumber>00000001</a:LicenseNumber>
<a:LicenseType>RN</a:LicenseType>
<a:FirstName>JANE</a:FirstName>
<a:LastName>PUBLIC</a:LastName>
<a:RecordID/>
<a:LicenseStatusChange>Active status changed</a:LicenseStatusChange>
<a:NotificationDate>2018-01-05T00:00:00</a:NotificationDate>
<a:DisciplineStatusChange>--</a:DisciplineStatusChange>
<a:DisciplineStatusChangeOther>--</a:DisciplineStatusChangeOther>
</a:NotificationResponse>
</NotificationResponses>
<Transaction xmlns:a="http://com.nursys.services.ServiceModel/2012/Transaction"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:TransactionID>12345</a:TransactionID>
<a:TransactionDate>2018-01-31T09:14:43.0942004-06:00</a:TransactionDate>
<a:TransactionComment/>
<a:TransactionSuccessFlag>true</a:TransactionSuccessFlag>
<a:TransactionErrors/>
</Transaction>
</NotificationLookupResponse>
</s:Body>
</s:Envelope>
Value Notes
AK ALASKA
AL ALABAMA
AR ARKANSAS
AS AMERICAN SAMOA
AZ ARIZONA
CARN CALIFORNIA – RN
CAVN CALIFORNIA – VN
CO COLORADO
CT CONNECTICUT
DC DISTRICT OF COLUMBIA
DE DELAWARE
FL FLORIDA
GA GEORGIA
GU GUAM
HI HAWAII
IA IOWA
ID IDAHO
IL ILLINOIS
IN INDIANA
KS KANSAS
KY KENTUCKY
LARN LOUISIANA – RN
LAPN LOUISIANA – PN
MA MASSACHUSETTS
MD MARYLAND
ME MAINE
MI MICHIGAN
MN MINNESOTA
MO MISSOURI
MP NORTHERN MARIANA ISLANDS
MS MISSISSIPPI
MT MONTANA
NC NORTH CAROLINA
ND NORTH DAKOTA
NE NEBRASKA
NH NEW HAMPSHIRE
NJ NEW JERSEY
NM NEW MEXICO
NV NEVADA
NY NEW YORK
OH OHIO
OK OKLAHOMA
OR OREGON
PA PENNSYLVANIA
A.3 States
Value Notes
AK ALASKA
AL ALABAMA
AR ARKANSAS
AS AMERICAN SAMOA
AZ ARIZONA
CA CALIFORNIA
CO COLORADO
CT CONNECTICUT
DC DISTRICT OF COLUMBIA
DE DELAWARE
FL FLORIDA
FM FED STATES OF MICRONESIA
GA GEORGIA
GU GUAM
HI HAWAII
IA IOWA
ID IDAHO
IL ILLINOIS
IN INDIANA
KS KANSAS
KY KENTUCKY
LA LOUISIANA
MA MASSACHUSETTS
MD MARYLAND
ME MAINE
MH MARSHALL ISLANDS
MI MICHIGAN
1 Critical Care
2 Adult Health/Family Health
3 Anesthesia
4 Community Health
5 Geriatric/Gerontology
7 Obstetrics
8 Medical Surgical
9 Occupational health
10 Oncology
11 Palliative Care
12 Pediatrics/Neonatal
14 Psychiatric/Mental Health
15 Rehabilitation
17 Trauma
18 Women’s Health
20 Operating Room
21 Emergency Room
22 Radiology
23 Recovery
24 Transplant
25 Substance Abuse
26 Cardiology
27 Neurology
0 Other
-1 Blank
Y Authorization to Practice
N No Authorization to Practice
C Contact Board of Nursing
X Non-participating Jurisdiction