Calendar API Reference

The Get Hearings resource in the MiCOURT Calendar API can be used to look up scheduled and historical hearings in a court or courts. Search results can be refined by filters.

Filtering

The fq parameter provides filter functionality to narrow the scope of your search. You can specify the fields and values that you would like your query to be filtered on. Separate the filter field name and value with a colon.

fq=actiontype:aj10

To apply multiple values to a single filter field, add a comma between each value:

fq=actiontype:aj10,aj16

To apply multiple filters to the query, append a separate fq parameter:

fq=actiontype:aj10&fq=hearingdatefrom:2019-06-29&fq=hearingdateto:2019-06-30

You can only have one instance of a filter field in the query. For instance, fq=actiontype:aj10&fq=actiontype:aj16 is not acceptable and will result in a 400 Bad Request response. The following table contains a list of the fields you can filter on. The text in the brackets ([]) indicate the values that are allowed for this filter.

Value			Description
-----------------------------------------------------------------------------------------------------------------------------------------
actionType		Return only hearings of this scheduling or action type code 
			Values:  Varies, depending on court type
			Example: actiontype:aj16
caseType		Return only hearings in cases having this case type
			Example: casetype:gc
caseTypeCategory	Return only hearings in cases with this case type classification
			Values:  [adoption,appeals,civil,criminal,domestic,juvenile,non-traffic,probate,traffic]
			Example: casetypecategory:criminal
courtroom		Return only hearings scheduled for this specific courtroom
			Example: courtroom:A
isPublic		Return only hearings with cases having a public visibility status
			Values:  [true,false]
			Example: casepublicstatus:all
judge			Return only hearings where the assigned judge matches this professional number
			Example: judge:098765
prosecutor		Return only hearings where the assigned prosecutor matches this professional number
			Example: procecutor:035343
hearingDateFrom		Return only hearings having a historical or scheduled hearing date on or after this date
			Example: filedatefrom:2019-05-05
hearingDateTo		Return only hearings having a historical or scheduled hearing date on or prior to this date
			Example: filedateto:2019-05-15
hearingTimeFrom		Return only hearings having a historical or scheduled hearing time on or after this date
			Example: createddatefrom:2019-02-02
hearingTimeTo		Return only hearings having a historical or scheduled hearing time on or prior to this date
			Example: createddateto:2019-02-03

Pagination

By default, the Get Hearings resource in the Calendar API returns 20 results at a time. Use the limit query parameter to control the number of results. To paginate through results, use the offset query parameter. For example, to get the first 10 hearings in a query that returns 50 total hearings, structure the query as follows:

limit=10&offset=0

To get the next 10 hearings (results 11-20), increase the offset value:

limit=10&offset=1

Sorting

Query results can be sorted with the sort query parameter. The possible sort criteria are:

Value		Description
-----------------------------------------------------------------------------------------------------------------------------------------
courtroom	Sorts by courtroom (alphabetically, starting with "A")
judge		Sorts by judge professional number
newest		Sorts by scheduled or past hearing date, newest cases first
oldest		Sorts by scheduled or past hearing date, oldest cases first

You can apply multiple sorts to the query by appending a separate sort parameter. The first instance of the parameter in the query string defines the primary sort, the second is the secondary sort, and so on.