v1

latestOpenAPI 3.0.32026-07-132615.7 KB

Search sex offender records with JSON body

Recommended production method. Send your API key in X-API-Key or Authorization: Bearer and send search fields in the JSON body. Send optional X-Request-Id for customer-side request correlation. The standard endpoint also remains compatible with key in the JSON body for existing clients.

post/sexoffender

Headers

X-Request-Idstring

Optional opaque client correlation ID. Use a UUID or similar request ID; do not include names, emails, DOBs, member IDs, patient IDs, search values, or other sensitive data.

Request body

keystring

Your API key (required). If using POST, you can send it in X-API-Key or Authorization: Bearer instead.

firstNamestring

First name of offender

lastNamestring

Last name of offender

dobstring date

Date of birth (YYYY-MM-DD)

citystring

Residence city

statestring

Residence state (full name or 2-letter code)

zipcodestring

Residence zip code

addressstring

Street address search. Fuzzy by default; supports common address abbreviations and is billed at the fuzzy search rate (+$0.02/call). Do not combine with q or lat/lng. For mode=extensive, combine with firstName and lastName.

latnumber

Latitude for GIS radius search

lngnumber

Longitude for GIS radius search

radiusnumber

Radius in miles for GIS search (default 1, max 100)

mode'extensive'

Set to 'extensive' for alias search, state-level enrichment, and additional response fields (aliases, locations, stateData). +$0.05/call.

fuzzyboolean

Enable fuzzy name matching — handles typos, partial names, nicknames, hyphenated names, and address abbreviations. +$0.02/call.

qstring

Free-text search across names, aliases, address, city, and zip code. Use with fuzzy=true instead of firstName/lastName.

prefixMatch'firstName' | 'lastName'

Enable prefix matching on the specified name field

uuidstring

Pull a single record by UUID

personUuidstring

Pull a single record by Person UUID

faceIdstring

Face ID from Facial Search API

createdAtStartstring date

Filter by first appearance in system (YYYY-MM-DD)

createdAtEndstring date

Filter by first appearance in system (YYYY-MM-DD)

updatedAtStartstring date

Filter by last update in system (YYYY-MM-DD)

updatedAtEndstring date

Filter by last update in system (YYYY-MM-DD)

pageinteger

Page number for GIS search pagination. Each page is billed as a separate API call.

Example request

{
  "firstName": "John",
  "lastName": "Smith",
  "dob": "1990-01-15",
  "city": "San Francisco",
  "state": "California",
  "zipcode": "94104",
  "address": "123 Main St",
  "lat": 30.967,
  "lng": -91.116,
  "q": "John Smith San Francisco"
}

Response

Successful search

pageinteger

Current page (GIS only)

totalPagesinteger

Total pages (GIS only)

Example response

{
  "offenders": [
    {
      "name": "JOHN M DOE",
      "firstName": "JOHN",
      "lastName": "DOE",
      "dob": "1990-01-15T00:00:00.000Z",
      "dobPrecision": "exact",
      "address": "123 MAIN ST",
      "city": "RICHMOND",
      "state": "Virginia",
      "zipcode": "23219",
      "locations": [
        {
          "type": "RES (Primary)"
        }
      ],
      "sex": "Male",
      "age": "35",
      "eyeColor": "Brown",
      "hairColor": "Black",
      "height": "5 ft 10 in",
      "weight": "180 lbs.",
      "race": "White",
      "ethnicity": "Non-Hispanic",
      "marks": "TAT R ARM",
      "riskLevel": "Tier 3",
      "crime": "SEXUAL ASSAULT (01/15/2005)",
      "lat": 37.5407,
      "lng": -77.436,
      "jurisdiction": "VA",
      "sources": [
        {
          "id": "nsopw",
          "name": "National Sex Offender Public Website"
        }
      ],
      "stateData": {
        "status": "Active",
        "designation": "Sexually Violent Offender",
        "locations": [
          {
            "type": "RES (Primary)"
          }
        ]
      }
    }
  ]
}