Case Search API Reference
The MiCOURT Case Search API can be used to look up cases in a court or courts by case number or participant name. Search results can be refined by filters. This API may be called by developers with only a Starter subscription but certain functionality limitations apply (as noted below).
Searching
Use the caseNumber, firstName, and lastName parameters for searching. The caseNumber searches will find any cases that contain that search value within the case number.
casenumber=123456
The name searches will find any cases that have a participant name that begins with the search value.
firstname=john&lastname=doe
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=casetype:gc
To apply multiple values to a single filter field, add a comma between each value:
fq=casetype=dm,gc,fc
To apply multiple filters to the query, append a separate fq parameter:
fq=casetype:dm&fq=caseyear:2019&fq=filedatefrom:2019-06-01&fq=filedateto:2019-06-30
You can only have one instance of a filter field in the query. For instance, fq=casetype:dm&fq=casetype:gc 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
-----------------------------------------------------------------------------------------------------------------------------------------
caseType Return only cases having this case type code
Values: Varies, depending on court type
Example: casetype:gc
caseTypeCategory Return only cases having this case type classification
Values: [adoption,appeals,civil,criminal,domestic,juvenile,non-traffic,probate,traffic]
Example: casetypecategory:criminal
caseTypeSubCategory Return only cases having this case type sub-classification
Example: casetypecategory:criminal
caseYear Return only cases filed in this calendar year
Example: caseyear:2018
caseStatus Return only cases having this case status
Values: [adr, closed, deferred, disposed, mediation, open]
Example: casestatus:open
casePublicStatus Return only cases having this public visibility status
Values: [public,suppressed]
Example: casepublicstatus:all
judge Return only cases where the assigned judge matches this professional number
Example: judge:098765
dob Return only cases that have a participant with this date of birth
Example: dob:1980-07-07
petitionStatus For juvenile cases, return only cases that have this petition status
Values: [open,closed]
Example: petitionstatus:open
amountDue Return only cases having a balance due greater than this number
Example: amountdue:15
amountPaid Return only cases where payments greater than this amount were applied to the balance due
Example: amountpaid:0
fileDateFrom Return only cases having a file date on or after this date
Example: filedatefrom:2019-05-05
fileDateTo Return only cases having a file date on or prior to this date
Example: filedateto:2019-05-15
createdDateFrom Return only cases that were created in the case management system on or after this date
Example: createddatefrom:2019-02-02
createdDateTo Return only cases that were created in the case management system on or prior to this date
Example: createddateto:2019-02-03
modifiedDateFrom Return only cases that were updated in the case management system on or after this date
Example: modifieddatefrom:2019-03-03
modifiedDateTo Return only cases that were updated in the case management system on or prior to this date
Example: modifieddateto:2019-03-04
dueDateFrom Return only cases having a payment due date on or after this date
Example: duedatefrom:2019-07-07
dueDateTo Return only cases having a payment due date on or prior to this date
Example: duedateto:2019-07-14
offenseDateFrom Return only cases having an offense date on or after this date
Example: offensedatefrom:2019-08-13
offenseDateTo Return only cases having an offense date on or prior to this date
Example: offensedateto:2019-08-14
dispositionDateFrom Return only cases having a case disposition date on or after this date
Example: dispositiondatefrom:2019-01-01
dispositionDateTo Return only cases having a case disposition date on or prior to this date
Example: dispositiondateto:2019-01-07
dln Return only cases that have a participant with this driver's license number
Example: dln:S455455455736
dlnState Return only cases that have a participant with this driver's license issuing state
Example: dlnstate:mi
vpn Return only cases having this vehicle plate number associated to the case
Example: vpn:4448FW
vpnState Return only cases having this vehicle plate issuing state associated to the case
Example: vpnstate:wi
Pagination
By default, the Case Search API returns 20 results at a time. If you have permissions to the court tenant in your request, you can increase that number to a maximum of 500 results at 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 cases in a query that returns 50 total cases, structure the query as follows:
limit=10&offset=0
To get the next 10 cases (results 11-20), increase the offset value:
limit=10&offset=1
Note: developers with a Starter subscription will only be returned the first 10 results of a search. Changing the limit or offset values will have no effect.
Sorting
Query results can be sorted with the sort query parameter. The possible sort criteria are:
Value Description
-----------------------------------------------------------------------------------------------------------------------------------------
caseDocketId Sorts by case year (newest first), then case number (highest number first), then case type (alphabetically, starting with "Z")
caseTrackingId Sorts by case year (newest first), then case number (highest number first), then original case type (alphabetically, starting with "Z")
newest Sorts by case creation date, newest cases first
oldest Sorts by case creation 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.
Expansion
The Case Search API supports the expansion of certain resources. Use the expand query parameter to do so. If no values are specified for expand, the core Case model will be returned. If you do provide values for expand, the Case model will contain sub-resources for the resources you requested. So rather than make multiple calls to get the information you need, you can make one search call and expand only the information you need.
expand=judge
If you want to expand more than one resource, append a separate expand parameter to the query:
expand=judge&expand=participants&expand=charges
Note that expansion may increase the response time of the query, so use expansion only when you need that data in your search results. The resources that can be expanded in the Case model are:
caseAge
caseType
charges
judge
nextHearing
participants
petitions
prosector
referee
Note: developers with a Starter subscription will not be allowed to use expand functionality.