GET odcr/search
Provides a mechanism to search for cases by several different parameters.
This resource includes all of the fields available with the ODCR.com Advanced Tools search including looking up parties by name, date of birth, address and more.
Many of the parameters have special requirements for searching such as length and formatting. Many of the parameters also accept wildcard characters to make the search broader.
Wildcards
- * — Matches any string of zero or more characters. — Smith, J*n will match Jon, John and Jen Smith.
- ? — Matches any single character. — Smith, J?n will match both Jon and Jen Smith.
Resource URL
https://api.kellpro.com/v2/odcr/search.format
Parameters
A specific activity date to search for. Must be formatted as a valid date.
Example: 2011-03-02
An address of any party associated with the case. This parameter accepts wildcard characters and will return partially matched records.
Example: 128 EAST 31ST PLACE
The assigned case number piece of the full case identifier associated with the case. This parameter will be automatically zero padded to the correct length.
Example: 00210
The assigned case type piece of the full case identifier associated with the case.
Example: CM
The assigned case year piece of the full case identifier associated with the case. This parameter must be a two digit year.
Example: 03
The id assigned to the type of case associated with the case. Must be the numeric identifier which can be located by using the casetypes resource.
Example: 7
The city for any party associated with the case. This parameter accepts wildcard characters and will return partially matched records.
Example: TULSA
The ending date for a date range for when the case was closed. Must be accompanied by the closed_start parameter.
Example: 2011-10-31
The starting date for a date range for when the case was closed. Must be accompanied by the closed_end parameter.
Example: 2011-10-01
The assigned court code for the court where the case was filed. Must be one of the 4 character codes that can be found through the courts resource.
Example: 019B
The date of birth of any party associated with the case.
Example: 1975-01-30
The ending date for a date range for when the case was filed. Must be accompanied by the filed_start parameter.
Example: 2011-10-31
The starting date for a date range for when the case was filed. Must be accompanied by the filed_end parameter.
Example: 2011-10-01
Any offense associated with the case. This parameter accepts wildcard characters and will return partially matched records.
Example: BURGLARY
Limits the results returned to those with, or without outstanding warrants. Must be one of the two strings in the example.
Example: outstanding | non-outstanding
Specifies which page of the results to return. Can be used to page through the results returned. The response will also returns a reference to the next & previous pages if they exist. The page numbering starts at 1, not 0.
Example: 3
The party name to search for. Must be formatted as Last, First to match party names. This parameter accepts wildcard characters and will return partially matched records.
Example: Smith, John D
The type of party to search for. Must be one of the 1 character codes that can be found through the partytypes resource. Can also be All or P+D for Plaintiffs and Defendants.
Example: All | P+D | J | ...
An integer for the number of results to return on each page of results. Can be any number between 1 and 100.
Example: 10
The state for any party associated with the case. This parameter must be the two character state abbreviation.
Example: OK
The zip code for any party associated with the case. This parameter will return partially matched records.
Example: 74105
Example Request
GET https://api.kellpro.com/v2/odcr/search.json?party=SMITH%2C+JOHN+DAVID&offense=DRIVING&per_page=2
{
"references":{
"next":"https://api.kellpro.com/v2/odcr/search?per_page=2&party=SMITH%2C+JOHN+DAVID&offense=DRIVING&page=2"
},
"results":[
{
"court":{
"reference":"https://api.kellpro.com/v2/odcr/courts?code=067-"
},
"case":{
"reference":"https://api.kellpro.com/v2/odcr/case?casekey=067-TR++0101732"
},
"casekey":"067-TR 0101732",
"party":"SMITH, JOHN DAVID",
"caseType":"TR",
"caseYear":"01",
"caseNumber":"01732",
"filedDate":"2001-07-25",
"style":"STATE OF OKLAHOMA VS. SMITH, JOHN DAVID",
"offense":"DRIVING UNDER SUSPENSION - ST GUILTY PLEA",
"disposition":"Guilty Plea",
"outstandingWarrant":false,
"offenses":{
"reference":"https://api.kellpro.com/v2/odcr/offenses?casekey=067-TR++0101732"
},
"dispositions":{
"reference":"https://api.kellpro.com/v2/odcr/dispositions?casekey=067-TR++0101732"
},
"people":{
"reference":"https://api.kellpro.com/v2/odcr/people?casekey=067-TR++0101732"
},
"activities":{
"reference":"https://api.kellpro.com/v2/odcr/activities?casekey=067-TR++0101732"
}
},
{
"court":{
"reference":"https://api.kellpro.com/v2/odcr/courts?code=019B"
},
"case":{
"reference":"https://api.kellpro.com/v2/odcr/case?casekey=019BCM++0300210"
},
"casekey":"019BCM 0300210",
"party":"SMITH, JOHN DAVID",
"caseType":"CM",
"caseYear":"03",
"caseNumber":"00210",
"filedDate":"2003-06-18",
"style":"STATE OF OKLAHOMA VS. SMITH, JOHN DAVID",
"offense":"AGGRAVATED DRIVING UNDER THE INFLUENCE",
"disposition":"Pending Deferred",
"outstandingWarrant":false,
"offenses":{
"reference":"https://api.kellpro.com/v2/odcr/offenses?casekey=019BCM++0300210"
},
"dispositions":{
"reference":"https://api.kellpro.com/v2/odcr/dispositions?casekey=019BCM++0300210"
},
"people":{
"reference":"https://api.kellpro.com/v2/odcr/people?casekey=019BCM++0300210"
},
"activities":{
"reference":"https://api.kellpro.com/v2/odcr/activities?casekey=019BCM++0300210"
}
}
]
}