Global NDD - National Criminal Check

12 min

Introduction

This API from Signzy is used to check for any criminal records of an individual.

How to call the API

You must first login before sending the request. The authorization header in the request must include the access token obtained from the login API call.

API Input Guidelines

Need to pass the following information. Atleast one of the birthYear, birthMonth and birthDate must be passed mandatorily.

subject
birthYear
birthDay
birthMonth

Sample cURL

Production

curl --location --request POST 'https://api.signzy.app/api/v3/global/nat-crim-check' \
--header 'Authorization: <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "subject": "Joe Sample",
    "birthYear": 1966,
    "birthMonth": 8,
    "birthDay": 6,
    "recordState": ["OH","TX"],
    "includeblankDOB": true
}'

Input Parameters

PARAMETER NAME	MANDATORY	DESCRIPTION
Content-Type	true	application/json
Authorization	true	Authorization token
subject	true	Name of the subject
birthYear	false*	Year of birth of the subject
birthMonth	*	Month of birth of the subject
birthDay	false* false* false*	Date of birth of the subject
recordState	false true true	Array of US states codes
includeBlankDOB	false	Boolean value to determine whether response must contain blank DOB records.

Sample Response

{
    "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
            }
        ]
    }
}

Response Parameters

PARAMETER NAME	DESCRIPTION
result	This parameter contains the actual output.
result.recordsFound	Boolean value based on whether records were found.
result.subject	subject name
result.criminalRecords	Array of criminal records.

Criminal Record Key	Dercription
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.
offences	Array of offences
names	Array of names from the record(s).
addresses	Array of addresses from the record(s).
dobs	Array of date of birth from the record(s).
jurisdiction	Jurisdiction of the record.

Offences Keys	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"
offenceDatw	Date the offense occurred. Ex: "2003-07-28"
offenceClass	Internal classification field.
offenceSubclass	Internal subclassification field.
offenceDescr	Offense description from the source. Ex: "SEXUAL ASSAULT CHILD", "BATTERy', "AGGRAV STALKING"
offenceDegree	Degree of the offense from the source. Ex: "FELONY", "Misdemeanor", "Infraction"
offenceLevel	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"

Name Key	DESCRIPTION
fullName	Full Name
firstName	First Name
middleName	Middle Name
lastName	Last Name
suffixes	Typically a generational title. Ex: "JR", "2nd", "IV"

Address Key	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 Key	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 Key	DESCRIPTION
county	County jurisdiction associated with the record. Ex: "Harris"
state	State jurisdiction associated with the record. Ex: "TX"

Sample Error

{
    "error": {
        "name": "error",
        "message": "Invalid Date",
        "status": 400,
        "reason": "VALIDATION_ERROR",
        "type": "Bad Request",
        "statusCode": 200
    }
}

Response Parameter

PARAMETER NAME	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 [email protected].