National Criminal Screening (US only)
National Criminal Screening delivers unrivaled coverage, accuracy and compliance of criminal data collected daily from thousands of sources at the federal, state, county, and local levels.
Sources include Criminal Prosecutions, Arrest Records, Warrant Lists, Criminal Newsletters & Press Releases, Most Wanted, Sex Offenders, Corrections/Inmate Data, Child Support Violations, Open Court Cases, Early Release & Parole Lists, Career Offenders, and more.
Data is updated in real-time to provide an accurate report of all court records in a certain region or jurisdiction, not just convictions. Our Criminal data is 100% from applicable government sources. Access is subject to each individual source’s infrastructure and their update schedules (scraped or direct integrations), which we follow accordingly to ensure the most up to date data is available.
For example, for finding the sex offenders, either check if Criminal Record Source Type is "sexoffenderlist" in response or check if Offense Class is "sex" with Criminal Record Source Type being "court".
API Authentication
Before using the National Criminal Screening API, you must authenticate by logging in and obtaining an access token. Include this token in the Authorization header of your request.
Required Parameters
Need to pass the following information. Atleast one of the birthYear, birthMonth and birthDate must be passed mandatorily.
subject
birthYear
birthDay
birthMonth
Example Request
To execute the "nat_crime_check" method using cURL, use the sample request below. Replace the placeholder values as needed:
Replace <Your_API_Key> and <Your_Lookup_ID> with your actual API key and lookup ID.
Understanding the Parameters
Below is a detailed explanation of the request and response body parameters used in executing the "nat_crime_check" method. Each parameter, along with its data type and description, is outlined to provide clarity on the required and optional fields for making successful API calls.
Request Body Parameters
subject
string
Yes
Name of individual. Format: First Middle Last
Atleast First and last name should be there.
birthYear
integer
Optional*
* While DOB fields are optional, at least one of the elements must have a value. For the best results, at least the year of birth should be included.
Year of the subject's birthday. Format: YYYY
Age should be between 18 and 110.
birthMonth
integer
Optional*
Month of the subject's birthday. Format: MM (do not zero fill. For example for the Month of March Submit a 3 not 03)
birthDay
integer
Optional*
Day of the month of the subjects's birthday. Format: DD (do not zero fill. For example for the 9th of March submit a 9 not 09)
recordState
string array
Optional
An array of US states the criminal record is from. Format: two digit State Code with a comma separator. For example Georgia would be GA. By Default, all states will be searched.
icludeBlankDOB
boolean
Optional
Return records that have blank DOB but meet other search criteria. Format: true or false, lower case.
Default : true. Option will be given to client.
Request Response Data
https://irbis.espysys.com/api/request-monitor/api-usage/{id}?key={API key}
Request to get a lookup data of a request with an id.
"id" parameter has to be passed in the path of a request - ID of a request to get lookup data for.
Example Path Variables
id: The unique identifier for the request you wish to look up.
API key: Your specific API key for authentication purposes.
CURL Example
Replace <id> with the request ID you are querying and <API_Key> with your actual API key.
Search Response Schema
Criminal Records Documentation
The following sections provide detailed explanations of the parameters found within criminal record reports:
Response Body Parameters
result: Contains the main output of the search.
result.recordsFound: Boolean indicating if records were found.
result.subject: Name of the individual searched.
result.criminalRecords: Array of criminal records related to the individual.
Criminal Record Parameters
Each criminal record contains various parameters:
id: A unique internal identifier for the record.
caseNumber: The case number associated with the record.
caseType: Type of case as defined by the source.
firstName, middleName, lastName, fullName: Name details of the defendant.
dob: Date of birth in YYYY-MM-DD format.
race, ethnicity, hairColor, eyeColor: Physical attributes.
height, weight, skin, build: Additional physical descriptors.
gender: Gender of the defendant.
source, sourceName: Internal identifier and name of the information source.
convictionDate, status, sentence: Details regarding conviction and sentencing.
arrestingAgency: Agency responsible for the arrest.
docNumber, sorNumber: Department of corrections number and sex offender registry number.
criminalRecordSourceType, criminalRecordSourceSubType: Source classification fields.
resultId, idProfile: Identifiers for search results and dispute purposes.
offenses: Array detailing specific offenses.
Offense Parameters
caseNumber: The case number for the offense.
caseType: Type of case related to the offense.
offenseDate: Date when the offense occurred.
offenseClass, offenseSubclass: Internal classification fields.
offenseDescr: Description of the offense.
offenseDegree, offenseLevel: Degree and level of the offense.
sentenceDate, sentenceType: Details about sentencing.
incarcerationDate, arrestDate: Dates of incarceration and arrest.
arrestingAgency: Agency that made the arrest.
courtCaseNumber, courtName: Court details handling the offense.
releaseDate, recordDate, caseFilingDate: Dates related to case processing.
Disposition, dispositionType, dispositionDate: Information about the disposition of the offense.
county, convictionJurisdiction, convictionDate: Jurisdiction and conviction details.
Offense Class Descriptions
Offense Category
Offense Class
Criminal Record Source Type
Offense Description
Sex Offenses
"sex"
"court"
Court record offenses associated with sexual assault, child pornography, molestation, or lewd and lascivious acts
Violence & Threats Offenses
"violence"
"court"
Court record offenses associated with murder, acts of assault, kidnapping, harassment, armed robbery, weapons, or battery
Property & Theft Offenses
"property"
"court"
Court record offenses associated with vandalism and damage to property, trespassing, burglary, larceny, shoplifting, petty, or grand theft
Substance Abuse Offenses
"substance"
"court"
Court record offenses associated with illegal possession, distribution, or abuse of controlled and regulated substances
Financial Offenses
"financial"
"court"
Court record offenses associated with financial fraud, identity theft, forgery, or embezzlement
Public Conduct Offenses
"public conduct"
"court"
Court record offenses associated with public behavior deemed by a state to be offensive, disruptive, or dangerous
Justice System Offenses
"justice system"
"court"
Court record offenses associated with the obstruction of justice, interference in the administration of the courts, or hindrance of law enforcement
Traffic Offenses
"traffic"
"court"
Court record offenses associated with driving misdemeanors, infractions, or violations
Other Offenses
"other"
"court"
Court record offenses that were not automatically categorized by our classifier based off of their descriptions
Unspecified Offenses
"unspecified"
"court"
Unspecified court record offenses
Watchlists
any of the above offense classes
"watchlist"
Watchlist records associated with threats to national security, foreign policy, health and human services, or the economy
Registered Sex Offenders
"sex" or "violence"
"sex offender list"
Presence on a sex offender registry
Offense Subclass Descriptions
Offense Category
Offense Class
Offense Subclass
Examples
Financial
financial
bribery & corruption
Attempts to illegally influence the actions of third parties, the unlawful use of one’s position to evade the law, etc.
embezzlement
Misuse of funds or property entrusted to someone, resulting in personal gain.
forgery
The false making or altering of awriting that would regularly have legal effect. Includes counterfeiting.
fraud
The use of deceitful practices to deprive another of his rights or to cause injury. Includes writing bad checks, using a stolen credit card.
gambling
Illegal betting or wagering.
identity theft
Illegally obtaining and using another’s personal information.
other financial
Other financial offenses not falling into a specific category. This category includes money laundering, insider trading, tax crimes, etc.
Justice System
justice system
arrest
Offenses involving the apprehension of an individual by law enforcement. This category includes resisting, delaying, hindering, fleeing and eluding, providing false ID to law enforcement, etc.
court administration
Acts or omissions by a person that interfere with the administration of judicial proceedings. This category includes failure to appear (FTA), failure to pay (FTP), failure to comply (FTC), obstruction, violations of sentencing terms or probation, etc.
escape
Attempts to escape the custody of a jail or prison.
failure to register
Failure to register, either as a sex offender, or sexually violent predator, or as a felon when required.
forfeiture
Confiscation of property by authorities, typically when the property was used in the commission of a crime.
warrants
Records of warrants, extradition orders, and holds.
Sex
sex
child pornography
Possession, use, distribution, sale, or creation of child pornography.
exposure & lewdness
Public sexual indecency.
rape
Sexual acts performed against a victim’s will.
sexual assault
Sexual physical advances against a victim.
sexual exploitation
Non-consensual acts of abuse or exploitation against another person for the purpose of sexual gratification, financial gain, personal benefit or advantage, or any other non-legitimate purpose.
sexual solicitation
Soliciting non-consensual sexual activity. Does not include prostitution.
other sex
Other offenses of a sexual nature that do not fall into a specific category, such as incest.
Substance
substance
alcohol use
Offenses in which the consumption or use of alcohol is a main factor. This category includes minor in possession charges and habitual offender charges, but does not include DUI/DWI.
impaired driving
Alcohol and substance-related offenses committed while operating a motor vehicle. This category includes DUI and DWI.
marijuana use, description
Personal use and possession of marijuana. Trafficking is not included in this category.
schedule I & II drug use
The use and possession of drugs classified as Schedule I or II drugs. This category includes cocaine, LSD, heroin, meth, morphine, codeine, opium etc.
schedule III to V drug use
The use and possession of drugs classified as Schedule III, IV, or V drugs. This category includes common prescription drugs such as Xanax, Valium, or Robitussin AC.
trafficking
Controlled substance distribution crimes, including sale, smuggling, trafficking possession with intent to distribute, etc.
other substance
Other offenses involving controlled substances that do not fall into a specific category.
Violence & Threats
violence
child neglect
Passive harmful offenses against minors.
elder neglect
Passive harmful offenses against the elderly.
child abuse
Active harmful offenses against minors.
elder abuse
Active harmful offenses against the elderly.
coercion
Compelling, forcing, or requiring another to perform a certain action. Such compulsion can be the result of physical or implied force. Crimes in this category include blackmail, extortion, etc.
homicide with intent
The intentional death of another person. This category includes murder.
homicide without intent
The unintentional death of another person. This category includes unintentional manslaughter and vehicular manslaughter.
other homicide
The death of another person. This category includes assisting suicide, euthanasia, illegal feticide, and homicides where the intent is not specified.
deprivation of liberty
The physical restraint or forced movement of another person. Crimes in this category include kidnapping, exploitation, abduction, forced labor, restraint, hijacking, etc.
emotional distress
Invasion of one’s privacy, actions causing another person to feel emotional anguish, and actions that lead a person to fear for his/her safety. This category includes harassment, stalking, threats, invasion of privacy, etc.
endangerment
Behavior which puts the life or safety of another person at risk. This category includes negligent supervision.
physical violence
Offenses involving an element of physical violence, including assault, battery, trafficking in people, etc.
simple assault
Simple assault.
aggravated assault
Aggravated assault.
other violence
Other offenses of a violent nature that do not fall into a specific category, or are not more specifically categorizable, such as assault with no other information
Property & Theft
property
arson
Setting fire to a structure. burglary The illegal entry into another’s property with the intent to commit a crime therein. This category includes breaking and entering.
robbery
The use of force to deprive another of their property.
theft & possession of stolen goods
The illegal carrying away of another’s property or the possession of stolen goods.
theft of intellectual property
The misuse of another’s intellectual property, including trademarks, copyrights, and patents.
trespassing
Entry into another’s property without lawful authority to do so. vandalism &
mischief
The alteration of, or damage to, another’s property.
other property
Other offenses involving another’s property that do not fall into a specific category.
Public Conduct
public conduct
cybercrime
Offenses committed through, or with the assistance of, a computer or computer network.
disturbing the peace
Disorderly conduct that deprives others of their right to peace and tranquility.
incitement
Attempts to motivate others to act illegally.
loitering & vagrancy
Consistent presence in a location without legal reason.
obscenity
Conduct considered to be offensive or indecent which has the effect of corrupting public morals. This category includes obscene gestures, obscene language, etc.
prostitution
The illegal sale of sex. public intoxication Being intoxicated in a public space.
other public conduct
Other offenses involving public conduct that do not fall into a specific category.
Traffic
traffic
accident
Motor vehicle offenses involving collision, including accidents, hit and run, leaving the scene of accident. equipment Motor vehicle offenses related to vehicle equipment.
impairment
Offenses involving the testing for and evidence of driver impairment. This category i ncludes open container charges, chemical test refusals, etc.
license & documentation
Offenses related to drivers’ administrative obligations, including registration, insurance, expired and suspended DL, etc
non-motor
Traffic offenses that do not involve the use of a motor vehicle. This category includes offenses related to jaywalking, bicycling, etc.
parking
Parking offenses.
restraint
Offenses related to the misuse or failure to use safety devices in a motor vehicle. This category includes failure to use restraint devices, failure to wear head protection, etc.
speed
Speeding offenses.
tolls
Toll-related offenses.
vehicular endangerment
Negligent or reckless use of a motor vehicle, including street racing, negligent driving, reck¬less driving, etc.
water
Boating-related offenses.
other traffic
Other traffic offenses that do not fall into a specific category.
Other
other
accessory
Offenses related to a person’s assistance in the commission of an offense, when the offense is otherwise unspecified.
animals
Offenses against animals, including cruelty, neglect, abuse, etc.
attempt
The attempt of a crime, when the offense is otherwise unspecified.
conspiracy
The joint-planning and carrying out of an offense, when the offense is otherwise unspecified.
environmental degradation
Harming the environment, including littering, pollution, and illegal dumping, logging, hunting, mining, fishing, etc.
injury to character
Defamation, including libel and slander.
protected species & objects
Offenses involving protected animals and plants. This category includes the movement, sale, or possession of protected flora, fauna, and archaeological ruins/objects, as well as offenses that degrade government-owned parks and sites.
weapons
Offenses involving objects and materials that have the propensity to injure. This category includes explosives, deadly weapons, illegal possession/sale/construction of firearms or other devices, etc.
welfare of minors
Negatively impacting the welfare of youth. This category includes giving alcohol to minors, giving pornographic material to minors, truancy, etc.
other
Other offenses that could not be categorized. This category includes offenses related to maritime law, piracy, labour law, immigration, election crimes, etc.
Unspecified
unspecified
unspecified
These offenses do not provide sufficient data to be categorized.
Other Parameters
Name Parameters
Description
fullName
Full Name
firstName
First Name
middleName
Middle Name
lastName
Last Name
suffixes
Typically a generational title. Ex: "JR", "2nd", "IV"
Address Parameters
Description
address1
Street number and street name or PO Box.
address2
Street address line 2 (continuation of above if needed).
city
City
state
State
zipCode
ZIP code
DOB Parameter
Description
date
Date of birth. Values are populated and returned as YYYY-MM-DD with zeros put in for elements that are missing. Ex: "1980-00-00", "1980-11-05", "1969-09-00"
Jurisdiction Parameters
Description
county
County jurisdiction associated with the record.
Ex: "Harris"
state
State jurisdiction associated with the record. Ex: "TX"
Last updated