National Criminal Screening

introduction national criminal screening of signzy 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 details sample curl curl location request post 'https //api signzy us/api/v3/global/nat crim check' \\ \ header 'authorization \<token>' \\ \ header 'content type application/json' \\ \ data raw '{ "subject" "\<name of individual>", "birthyear" \<year of the subject birthday>, "birthmonth" \<month of the subject birthday>, "birthday" \<date of the subject birthday>, "recordstate" \[\<states the criminal record is from>], "includeblankdob" \<true/false> }'curl location request post 'https //api preproduction signzy us/api/v3/global/nat crim check' \\ \ header 'authorization \<token>' \\ \ header 'content type application/json' \\ \ data raw '{ "subject" "\<name of individual>", "birthyear" \<year of the subject birthday>, "birthmonth" \<month of the subject birthday>, "birthday" \<date of the subject birthday>, "recordstate" \[\<states the criminal record is from>], "includeblankdob" \<true/false> }' request body parameters parameter data type required description content type yes application/json authorization yes authorization token subject string yes name of individual format first middle last atleast first and last name should be there birthyear integer optional either provide all three (birthyear, birthday, birthmonth) or just the birthyear or none of the dob fields year of the subject's birthday format yyyy age should be between 18 and 110 birthmonth integer optional either provide all three (birthyear, birthday, birthmonth) or just the birthyear or none of the dob fields month of the subject's birthday format mm birthday integer optional either provide all three (birthyear, birthday, birthmonth) or just the birthyear or none of the dob fields day of the month of the subjects's birthday format dd 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 includeblankdob 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 using date of birth filter if you include any date of birth (dob) information in the search request, it must include a birth year a request with only birth month and day (without a year) will result in the error only acceptable inputs are either pass only birth year or birth year + birth month + birth day any other combination of inputs will result in error if no dob is provided at all (i e , all dob fields are removed from the request), the search will still run successfully sample response 200 (data found) { "result" { "recordsfound" true, "subject" "john doe", "criminalrecords" \[ { "offenses" \[ { "casenumber" "md 0087633", "casetype" "adult misdemeanor", "offensedate" "1988 08 03", "offenseclass" "violence", "offensesubclass" "physical violence", "offensedescr" "assault causing bodily injury", "offensedegree" "nd", "offenselevel" "misdemeanor", "courtcasenumber" "md 0087633", "courtname" "county court at law no 1", "recorddate" "1985 03 21", "casefilingdate" "1985 03 21", "dispositiontype" "unknown" } ], "names" \[ { "fullname" "joe sample", "firstname" "joe", "middlename" "john", "lastname" "sample" } ], "addresses" \[ { "address1" "555 main st unit 702; texas", "city" "galveston", "state" "tx" } ], "dobs" \[ { "date" "1966 08 06" } ], "jurisdiction" { "county" "galveston", "state" "tx" }, "id" "1901xpaayxnoecy178a6e+mpwkq==", "firstname" "joe", "middlename" "john", "lastname" "sample", "fullname" "joe sample", "dob" "1966 08 06", "gender" "", "source" "tx galveston view", "sourcename" "tx galveston county courts", "criminalrecordsourcetype" "court", "criminalrecordsourcesubtype" "court", "resultid" 1 }, { "offenses" \[ { "offenseclass" "property", "offensesubclass" "burglary", "offensedescr" "burglary", "offenselevel" "unknown", "incarcerationdate" "1987 01 28", "courtname" "lawrence", "releasedate" "1987 03 27", "dispositiontype" "unknown", "convictionjurisdiction" "lawrence" } ], "names" \[ { "fullname" "joe sample", "firstname" "joe", "lastname" "sample" } ], "dobs" \[ { "date" "1966 08 06" } ], "jurisdiction" { "state" "oh" }, "id" "2201xberesnm9d3urqtstgssy9a==", "firstname" "joe", "lastname" "sample", "fullname" "sample, joe", "dob" "1966 08 06", "race" "black", "gender" "male", "source" "ohdoc", "sourcename" "oh dept of corrections", "criminalrecordsourcetype" "court", "criminalrecordsourcesubtype" "doc", "resultid" 2 } ] } } 200 (no data found) { "result" { "recordsfound" false, "subject" "john doe", "criminalrecords" \[] } } response body parameters parameter description result this parameter contains the actual output result recordsfound boolean value based on whether records were found result subject name of individual searched result criminalrecords array of criminal records criminal record parameters criminal record parameter description id internal identifier for the record ex "mcrdcrtr030001124001joscro" casenumber case number of the record ex "095978301013" casetype case type of the record as defined by the source ex "minor offense", "fd", "misdemeanor class a", "felony 6" firstname first name of the defendant middlename middle name of the defendant lastname last name of the defendant fullname full name of the defendant dob date of birth of the defendant race race of the defendant ex "white" ethnicity ethnicity of the defendant ex "non hispanic" haircolor hair color of the defendant ex "bln", "blonde", "brown" eyecolor eye color of the defendant ex "brown" height height of the defendant ex "511" weight weight of the defendant ex "290" skin skin color of the defendant ex "fair", "mbr", "light brown" build build of the defendant ex "extra l", "obese" gender gender of the offender ex "unknown", "male", "female", "nonbinary" source internal identifier for the source ex "ne doc view" sourcename name of source ex "ne dept of corrections" convinctiondate date the defendant was convicted ex "2004 06 03" status status of the offender ex "disposed", "released on recognizance", "active", incarcerated sentence description of the sentence ex "probation 1 year", "pts enhanced supervision" arrestingagency arresting agency ex "benton county sheriff", "harris co so hourson" docnumber department of correction number for the offender ex "07355111" sornumber sex offender registry number for the offender ex "tx 7307320" criminalrecordsourcetype field for classifying the source ex "court", "sexoffenderlist", "watchlist" criminalrecordsourcesubtype field classifying the source subtype ex "arrest, "criminal registry", "court", "doc", domestic watchlist" resultid unique id for the search result idprofile unique id used when disputing results offenses array of offenses please refer the tables below for offenses parameters names array of names from the record(s) please refer the tables below for names parameters addresses array of addresses from the record(s) please refer the tables below for addresses parameters dobs array of date of birth from the record(s) please refer the tables below for dobs parameters jurisdiction jurisdiction of the record please refer the tables below for jurisdiction parameters offense parameters offenses parameter description casenumber case number of the offense ex "095978201010" casetype case type of the offense as defined by the source ex "felony", "gross misdemeanor", "offense infraction" offensedate date the offense occurred ex "2003 07 28" offenseclass internal classification field please refer the tables below for more details on offenseclass offensesubclass internal subclassification field please refer the tables below for more details on offensesubclass offensedescr offense description from the source ex "sexual assault child", "battery', "aggrav stalking" offensedegree degree of the offense from the source ex "felony", "misdemeanor", "infraction" offenselevel internal field classifying offense level ex "felony", "misdemeanor", "unknown", "infraction/violation/ordiance/traffic" sentencedate date the defendant was sentenced ex "2004 06 03" sentencetype type of sentence as defined by the source ex "fined", "failed", "probation" incarcerationdate date the defendant was incarcerated ex "2007 06 03" arrestdate date the defendant was arrested ex "2003 07 28" arrestingagency arresting agency exl united states marshall's service", "elwood police department", "madison county sheriff" courtcasenumber case number of the offense example "mcrdcrtr03 0001124 008" courtname name of the court that tried the defendant ex "ca shasta superior court", "ga dept of corrections (web)" releasedate release date of the offender ex "2019 03 26" recorddate internal field to calculate the age of the record ex "2003 02 19" casefilinfdate date the case was filed ex "2003 02 19" disposition disposition of the offense ex "dism other", "deferred adjudication terminated", "adjudicated guilty", "nolle prosequi", "dismissed caserefiled" dispositiontype internal field classifying the disposition ex "guilty", "not guilty", "withheld", "not disposed", "no verdict", "unknown" dispositiondate date the offense was disposed ex "2013 03 28" county county associated with the offense ex "benton", "jackson", "porter" convictionjurisdiction jurisdiction associated with the offense city, state, or county ex "woodbury", "black hawk", "hudson", "jersey city municipal court" convictiondate date of conviction ex "2004 06 03" 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" sample error 400 (dob validation) { "error" { "name" "error", "message" "invalid combination of month, day, and year either provide all three (birthyear, birthday, birthmonth) or just the birthyear ", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } \ { "error" { "name" "error", "message" "invalid birthyear age of the individual must be between 18 to 110", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } \ { "error" { "name" "error", "message" "\\"birthyear\\" must be a number", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } \ { "error" { "name" "error", "message" "\\"birthday\\" must be less than or equal to 31", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } \ { "error" { "name" "error", "message" "\\"birthmonth\\" must be less than or equal to 12", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } other 400 errors { "error" { "name" "error", "message" "subject must contain full name", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } \ { "error" { "name" "error", "message" "\\"subject\\" is required", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } \ { "error" { "name" "error", "message" "recordstate contains an invalid state code", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } 409 { "error" { "name" "error", "message" "error in getting data from upstream", "status" 409, "reason" "error", "type" "conflict", "statuscode" 409 } } 500 { "error" { "name" "error", "message" "internal server error", "status" 500, "reason" "error", "type" "conflict", "statuscode" 500 } } response parameter parameter description error this parameter contains the error error name the name of the error error message the error message error status status of the api error reason reason for error error type type of the error error statuscode request status code from signzy getting help please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better you can reach out to us at help\@signzy com we strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively we value your feedback and are committed to making your experience smooth and enjoyable our team is dedicated to assisting you with any needs you may have thank you for choosing our services we look forward to helping you!