Hearing Service Web Service Definition

Schedule 3

Referenced in Exhibit A of subscriber agreement

These web service calls allow users to obtain a list of the hearings on a case.  The primary purpose is to allow the user to verify the existence of a hearing, as well as its time and place. 

For notes on the Fair Credit Reporting Act (FCRA) and other general matters, see General notes on web services.

A SEARCHASES call is run first, based on the court and case number.  The XML search results can then be used to decide identify party of interest, which are then acquired using a GETCASE call.

Sample calls on Judici test server

If any of the following don't work, contact Web Service User Support

• Sample SEARCHASES call

• Sample GETCASE call 

SEARCHCASES call

https://www.judici.com/service/caseSearchService?SEARCHCASES&USERID=n

&APPID=a&KEY=0x&COURTID=ncic

&CASEID

COURTID parameter- this is the NCIC code of the court.  These can be found at the end of the link to each court on this page. (e.g. IL039015J)

CASEID parameter- this is composed of the different segments in sequence:

• Year

• TypeCode- case type.  Examples: CH (Chancery) 

• Sequence- a sequence/ordinal number within year and case type.  This should NOT be zero-padded.

The remaining search parameters are authentication parameters which will be provided with the credentials for the service.

Automatic filter criteria specific to this web service

• Cases which  are secured by the court (e.g. sealed, impounded etc.) will return no results.  

• All litigants on the case will be returned, including both real and (where present) alias identities

Data returned

• Search results include each litigant on the case. 

GETCASE call

This call retrieves a particular litigant's hearings, based on a CaseMD5 from a recent search and the Litigant ID.  While it’s uncommon, hearings are sometimes scheduled for only some of the litigants on the case.  So it’s safest to do the GETCASE on the specific litigant whose hearings you’re seeking.

https://www.judici.com/service/caseSearchService?GETCASE&

USERID=n&APPID=a &KEY=0x&COURTID=ncic

&CASEMD5=value from SEARCHCASES result

&LITIGANTID=value from SEARCHCASES result

All hearings, future (and past, if court retains them), will be returned.  Most of the results data is self-explanatory, but documentation on the various <Event> attributes returned is available here.

Special notes on remote proceedings- in Judici courts, video/remote/Zoom hearings are identified in one or both of the following ways:

1. By hearing type- some courts use a specific hearing type code of 182, found in the <Event>Code attribute.  Since using a hearing type to indicate video/remote proceedings obscures the actual nature of the hearing, some courts which use this method also schedule a parallel hearing at the same time using the "true" hearing type.

2. By courtroom (<Event>Location in the GETCASE results)- unfortunately, these are not standardized.  Some are self-evident: values starting with Z (e.g. ZM1), V (e.g. VID) or PH (e.g. PH1), but others are not so clear (e.g. "E" could mean electronic hearing, or it could be a physical courtroom).

The Illinois Supreme Court maintains this page, with the intent of providing links to individual courts' documentation about remote proceedings in each court. That documentation may or may not make clear how the court designates remote hearings.