Criminal search API

Search Type

Parameter

Example

Search By Name

URL

https://api.s2verifyconnect.com/crimdata/criminal.svc/xml

Basic search

https://api.s2verifyconnect.com/crimdata/criminal.svc/xml?disclaimers_agree=true&account=user&key=password&lastname=white&firstname=john

* Required parameters:disclaimers_agree, account, key, lastname, firstname

 

Search By ID (you can get id and source from index layout search)

URL

https://api.s2verifyconnect.com/crimdata/criminal.svc/xml/id

Source/ID search

source1 = [Source Name]
id1 = [Record ID]
source_layout=1 (or 2,3,4,5)

https://api.s2verifyconnect.com/crimdata/criminal.svc/xml/id?disclaimers_agree=true&account=user&key=password&search_type=&source_layout=1&source1=sorca&id1=1869424101075

Multiple Source/ID search

source1/id1
source2/id2
....
source10/id10
(Maximum: source10/id10 )

https://api.s2verifyconnect.com/crimdata/criminal.svc/xml/id?disclaimers_agree=true&account=user&key=password&source_layout=&source1=ARSTplacerca&id1=0611310%23&source2=sorca&id2=1869424101075&source3=sorhi&id3=A0157139OMAPET&source4=ncaoc&id4=01000ALAMANCE%20%20%20%201978CRS010230&source5=soraz&id5=000299&source6=ipol&id6=2005_45703&source7=ctaoc&id7=W11DCR020114740S&source8=flaoc&id8=52522001MM015789AXXXNO&source9=Rogers.ok&id9=10093034&source10=sc_laurens_circuit&id10=1710162211

If ID contains URL reserved characters such as +,?,%,# ,/ and &. Please encode these special characters as follow:
(+ : %2B) (/ : %2F) (? : %3F) (% : %25) (# : %23) (& : %26)

 

Layout parameters

Choose Index or source layout

search_type=0 source layout
search_type=1 index layout, only return source state,source id,name,DOB and ZIP 

example: https://api.s2verifyconnect.com/ws_criminal3/criminal.svc/xml?disclaimers_agree=true&account=user&key=password&lastname=white&firstname=john&middlename=k&DOB_yyyymmdd=19720417&state=NJ&search_type=1

Choose  different source layouts

Specify parameter search_type = 0
Specify parameter source_layout = 0~6 (click below links to see examples)
0=unified summary (56 most common fields for all sources with summary layout )
1=unified original(56 most common fields for all sources)
2=source summary (original source layout with summary layout )
3=source original (original source layout)
5=unified summary + separated charge info + source summary
6=unified summary + separated charge info 

Example: https://api.s2verifyconnect.com/ws_criminal3/criminal.svc/xml?disclaimers_agree=true&account=user&key=password&lastname=white&firstname=john&middlename=k&DOB_yyyymmdd=19720417&state=NJ&search_type=0&source_layout=5

default: search_type=0,source_layout=0

Parameters list [Required=R] [Optional=O]

Parameter

Name

Desc

R

Disclaimers_agree

Agree

disclaimers_agree = true (Agree to the term)

R

account

Your account

 

R

key

Your password

 

R(search by name)

lastname

Offender's Last name(support wildcard)

[ex: smith] [ex: jac* = jackson]

R(seach by name)

firstname

Offender's First name (support wildcard)

[ex: peter]

O

middlename

Offender's middle name(support wildcard)

[ex: a]

O

include_partial_middlename

Include records with partial or empty middle name

include_partial_middlename =  1
include records that match the first letter of middlename .

include_partial_middlename =  2
Include records that match the first letter of middlename or no middle name.

 

O

aka

Enable alias names search

aka =1
ex: when firstname = michael, system will match records with 'mike', 'micky','mick' or 'micah'

O

zipcode

Offender's zip code

 5 digit number 

O

state

US state

State abbreviations ex: CA, OH, VA... default = All . To specify more than one state, using comma between states such as  CA,HI,AZ

O

category

record category

No specified(Default) = All categories
CR = criminal
SX = Sex Offenders
AR = Arrest
WA = Warrant
MW = Most Wanted
PA = Patriot


Or combination of any above category
Examples:
AR,WA = Arrest + Warrant
CR,SX = Criminal + Sex offenders
CR,MW = Criminal + Most Wanted
SX,PA = Sex Offenders + Patriot
CR,SX,MW = Criminal + Sex offenders + Most Wanted
CR,SX,PA = Criminal + Sex offenders + Patriot

O

DOB_yyyymmdd

Offender's DOB

DOB in yyyymmdd format (support wildcard for mmdd)
[ex:19851206] [ex:1983* = 19830101 ~ 19831231]

O

include_partial_DOB

Include partial DOB match

include_partial_DOB = 1
(1)Records with DOB(exactly match)
(2)Records with partial DOB(YYYYMM match , DD = 00 or empty string)
(3)Records with partial DOB(YYYY match , MMDD = 0000 or empty string)
(4)Records with partial DOB(MMDD match , YYYY = 0000 or empty string)

include_partial_DOB = 2
include_partial_DOB = include_partial_DOB = 1 +  Records with no DOB info

include_partial_DOB = 3
include_partial_DOB = include_partial_DOB = 1 +  Records with partial DOB(YYYYMM match, DD = any date)

include_partial_DOB = 4
include_partial_DOB = include_partial_DOB = 1 +  Patriot with no DOB info

include_partial_DOB = 5
(1) Records with DOB (exactly match)
(2) Patriot with any or no DOB

include_partial_DOB = 6
(1) Include_partial_DOB=1
(2) Include CCYY match only (mmdd can be any value)
(3) Include MMDD match only (ccyy can be any value)
(4) SOR with any or no DOB (Name only match)
(5) Patriot with any or no DOB (Name only match)

include_partial_DOB = 7
(1) Include_partial_DOB=5
(4) SOR with exact DOB, CCYY0000 match or no DOB

 

include_partial_DOB = 8

(1) Records with exact DOB
(2) Patriot with any or no DOB

(3) SOR with exact DOB, CCYY0000 or no DOB
(4) DOC with exact DOB, CCYY0000 or no DOB

O

priority_states

High priority state(s)

Records from these states have high priority. such as  priority_states=CA,HI,AZ

 

O

priority_flag

Return records in different priority orders

priority_flag = 0
1. Exact DOB Matches +  High priority states
2. Exact DOB Matches + Low priority states
3. Partial DOB Matches + High priority states
4. Partial DOB Matches + Low priority states
5. NULL DOB Matches + High priority states
6. NULL DOB Matches + Low priority states

priority_flag = 1
1. Exact DOB Matches  + High priority states
2. Partial DOB Matches + High priority states 
3. NULL DOB Matches + High priority states
4. Exact DOB Matches + Low priority states 
5. Partial DOB Matches + Low priority states
6. NULL DOB Matches + Low priority states

priority_flag = 2
1. Record with DOB(exactly match) + middle name(exactly match)
2. Record with DOB(exactly match) + middle name (the first letter match)
3 .Record with DOB(exactly match) + no middle name info
4. Record with partial DOB(YYYYMM match, DD = 00 or empty string) + middle name(exactly match)
5. Record with partial DOB(YYYYMM match, DD = 00 or empty string) + middle name(the first letter match)
6. Record with partial DOB(YYYYMM match, DD = 00 or empty string) + no middle name info
7. Record with partial DOB(YYYY match, MMDD = 0000 or empty string) + middle name(exactly match)
8. Record with partial DOB(MMDD match, YYYY = 0000 or empty string) + middle name(exactly match)
9. Record with partial DOB(YYYY match, MMDD = 0000 or empty string) + middle name (the first letter match)
10. Record with partial DOB(MMDD match, YYYY = 0000 or empty string) + middle name (the first letter match)
11. Record with partial DOB(YYYY match, MMDD = 0000 or empty string) + no middle name info
12. Record with partial DOB(YYYY match, MMDD = 0000 or empty string) + no middle name info
13. Record with no DOB info + middle name(exactly match)
14. Record with no DOB info + middle name(the first letter match)
15. Record with no DOB info + no middle name info

priority_flag = 3
1. Record with DOB(exactly match) + middle name(exactly match)
2. Record with DOB(exactly match) + middle name (the first letter match)
3 .Record with DOB(exactly match) + no middle name info
4. Record with partial DOB(YYYYMM match, DD = 00 or empty string) + middle name(exactly match)
5. Record with partial DOB(YYYYMM match, DD = 00 or empty string) + middle name(the first letter match)
6. Record with partial DOB(YYYYMM match, DD = 00 or empty string) + no middle name info
7. Record with partial DOB(YYYY match, MMDD = 0000 or empty string) + middle name(exactly match)
8. Record with partial DOB(MMDD match, YYYY = 0000 or empty string) + middle name(exactly match)
9. Record with partial DOB(YYYY match, MMDD = 0000 or empty string) + middle name (the first letter match)
10. Record with partial DOB(MMDD match, YYYY = 0000 or empty string) + middle name (the first letter match)
11. Record with partial DOB(YYYY match, MMDD = 0000 or empty string) + no middle name info
12. Record with partial DOB(YYYY match, MMDD = 0000 or empty string) + no middle name info

13. Record with partial DOB(YYYYMM match, DD = any date) + middle name(exactly match)
14. Record with partial DOB(YYYYMM match, DD = any date) + middle name(the first letter match)
15. Record with partial DOB(YYYYMM match, DD = any date ) + no middle name info

16. Record with no DOB info + middle name(exactly match)
17. Record with no DOB info + middle name(the first letter match)
18. Record with no DOB info + no middle name info

O

search_type

specify search type

0:source table (default)
1: index table

O

source_layout

specify output layout for source table

0: unified summary(default)
1: unified original 
2. source summary
3. source original
5. hybrid 2 (unified summary) + (unmapping source fields)
6. unified summary + separated charge info

O

return_index_max

specify maximum records returned from the index table (specify range between 1~1000)

 

O

return_source_max

specify maximum records returned from the source table (specify range between 1~100)

 

O

all_sor

Include Sex Offenders records from all states

default = false. To enable it, set all_sor = true

O

all_patriot

Include Patriot records from all states

default = false. To enable it, set all_patriot = true

O

ref

Reference

Ref=Demo :Demonstration Call
Ref=CS :Customer Service or Programming Testing Calls

O

rvp

Record Validation Policy

1. No rvp parameter. Return all records only if users have permission
2. rvp=1. Only for users that have permission to access all but don't want to see RVP purged records in results
3. rvp=0. Return all records only if users have permission.

 

 

Error code

Desc

I0

[Input error]:Account and password are required

I1

[Input error]:Lastname and firstname are required

I2

[Input error]:Invalid DOB format

I3

[Input error]:Invalid account or password

D4

[Database error]:Fail to connect to account db

I5

[Input error]:'search_type' parameter can only be 0:source,1:index)

D6

[Database error]:Fail to access source list

I7

[Input error]:Return_index_max exceeds maximum allowed records (1~1000)

I8

[Input error]:Return_source_max exceeds maximum allowed records (1~100)

I9

[Input error]:Invalid search category. Please specify [CR],[SX],[AR],'[WA],[MW],[PA],[ALL],[AR,WA],[CR,SX],[CR,MW],[SX,PA],[CR,SX,MW] or [CR,SX,PA])(CR=Criminal, SX=Sex Offenders, AR=Arrest, WA=Warrant, MW=Most wanted, PA=Patriot)

I10

[Input error]:Invalid 'include_partial_DOB' value. Value can only be 1,2,3 or 4

I11

[Input error]:'DOB_yyyymmdd' is required when 'include_partial_DOB' is specified

D12

[Database error]: Fail to read the index table

D13

[Database error]: Fail to read source table(s)

I14

[Input error]: Parameter 'source_id_array' can only contains up to  maximum allowed [source/id] objects

I15

[Input error]: Invalid 'source_layout' parameter. Please specify value range between 0~6

I999

[Input error](To use this service, you must agree the term:Please read Disclaimers section on https://api.s2verifyconnect.com/ws_criminal2 If you agree the term please reset 'Disclaimers_agree' parameter in your code = true


Modify date

Desc

01/28/2010

Initial release (test vertsion)

02/09/2010

source_output_layout = 2 and 3 is available now

02/09/2010

Search by multiple source/id is available (see 'source_id_array' parameters)

02/09/2010

New error message 14

03/23/2010

New category (MW = Most Wanted)

03/23/2010

New parameter (include_partial_middlename)

08/20/2010

New function, search by SSN

12/15/2010

New parameters [all_sor] and [all_patriot]. 2. New category: [CR,SX,PA] = Criminal + Sex offender + Patriot

01/31/2011

Added New category (SX,PA = Sex offender + Patriot)

02/16/2011

Added the error codes table

03/25/2011

Added layout 6 (unified layout + separated charge info)

03/25/2011

Added error code I15

05/18/2011

Added new partial DOB parameter: include_partial_DOB = 5

05/18/2011

Combination of CR,SX,AR,WA,MW and PA are now supported

07/09/2012

Added Ref parameter

07/24/2013

Added include_partial_DOB = 7 parameter

04/18/2018

Added (1) include_partial_DOB = 8 parameter (2) RVP parameter (3) <Record_date> tag

2010 s2verifydata.com


Disclaimers 


  (1) The Provider of this information does not warrant the comprehensiveness, completeness, accuracy, or adequacy for any particular use or purpose of the information contained in this database and expressly disclaims all warranties express or implied as to any matter whatsoever. Provider will not be responsible for any loss or damage caused by the use of this data. Please be advised that many people share the same or similar names, and the same date of birth. Name and Date of Birth are not sufficient to establish identity.


  (2) NC Admin Office of Courts Disclaimer: "The official custodian of all official court records for each county in North Carolina is the clerk of superior court of that county. The North Carolina Administrative Office of the Courts (NCAOC) is not the official custodian of any case record and provides only copies of data entered by the clerks. Data provided through this service may not reflect pending or post-disposition activity on a case. The NCAOC does not warrant the accuracy of the data. To verify a record's accuracy, contact the clerk of the county of record."

(3) Unified Judicial System of the Commonwealth of Pennsylvania Notice and Disclaimer: Notice—The electronic case record information received from the Commonwealth is not an official case record; official case records are maintained by the court in which the record was filed. Disclaimer—The data or information provided is based upon information received by the Administrative Office of Pennsylvania Courts (AOPC). AOPC makes no representation as to the accuracy, completeness or utility, for any general or specific purpose, of the information provided and as such, assumes no liability for inaccurate or delayed data, errors or omissions. Use of this information is at your own risk. AOPC makes no representations regarding the identity of any persons whose names appear in the records. User should verify that the information is accurate and current by personally consulting the official record reposing in the court wherein the record is maintained. You agree that in the event of termination of the agreement with the Commonwealth, you will stop using the data and remove the data from your databases.

(4) The official custodian of all official court records for each court in Arkansas is the clerk of the court. The Arkansas Administrative Office of the Court (AOC) is not the official custodian of any case record and provides only copies of data entered or provided by clerks. Data provided through this service may not reflect pending or post-disposition activity on a case. The AOC does not warrant the accuracy of the data. To verify a records accuracy, contact the clerk of the court of record.