Search sex offender records

Changed on

Search the national sex offender registry by name, address, zip code, GPS coordinates, or free-text query. For quick demos, GET with the key query parameter remains supported. For production, prefer POST with X-API-Key or Authorization: Bearer and JSON body fields. Send optional X-Request-Id for customer-side request correlation.

get/sexoffender

Request

  • Base URL
    https://api.offenders.io
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer
    • or API key in query parameter key

Query parameters

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). Regular Search matches exact records by full date, year_month records by year and month, and year records by year. Records with no stored DOB are excluded. A record with unknown precision but a stored date must match the full date. Extensive Mode may also return possible matches with a partial or missing DOB. If a person has multiple official DOBs on file, Extensive Mode checks all of them.

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. If combined with mode=extensive, also send firstName and lastName so enriched name results can be filtered by address.

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' to check additional live sources and return aliases, locations, and stateData where available. If a person has multiple official DOBs on file, Extensive Mode checks all of them. Results with a partial or missing DOB may still appear, so the result count can differ from Regular Search. +$0.05/call.

fuzzyboolean

Enable typo-tolerant fuzzy name matching for structured name fields. Handles spelling variations, partial first names, nicknames, aliases, and hyphenated surnames. Structured address searches are fuzzy by default and do not require this flag. +$0.02/call.

qstring

Free-text search across names, aliases, address, city, and zip code. Fuzzy matching is enabled by default and billed at the fuzzy search rate (+$0.02/call); fuzzy=true is not required. Use instead of firstName/lastName.

historyboolean

For name searches using firstName or lastName: omit or set false for records updated within the past six months; set true to include older matching records. Explicit createdAt/updatedAt date ranges take precedence. Does not apply to GIS, free-text, address, ID lookups, or the History endpoints. Extensive Mode continues to include live matches.

prefixMatch'firstName' | 'lastName'

Enable prefix matching on the specified name field

uuidstring

Pull a single record by UUID

personUuidstring

Search 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, free-text (q), or address search pagination. Each page is billed as a separate API call.

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.

Response

Successful search

pageinteger

Current page for GIS, free-text (q), or address searches.

totalPagesinteger

Total pages for GIS, free-text (q), or address searches; 0 when no results are available.

errorinteger

GIS responses may include a top-level error status code when the location lookup is unavailable.

Example response

{
  "offenders": [
    {
      "name": "JOHN M DOE",
      "firstName": "JOHN",
      "lastName": "DOE",
      "dob": "1990-01-15T00:00:00.000Z",
      "dobPrecision": "exact",
      "additionalDobs": [
        {
          "dob": "1990-02-15T00:00:00.000Z"
        }
      ],
      "address": "123 MAIN ST",
      "city": "RICHMOND",
      "county": "RICHMOND CITY",
      "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\nSC L KNEE",
      "riskLevel": "Tier 3",
      "crime": "SEXUAL ASSAULT\nINDECENT EXPOSURE",
      "content": "<br><b>Zip Code:</b> 23219",
      "lat": 37.5407,
      "lng": -77.436,
      "jurisdiction": "VA",
      "sources": [
        {
          "id": "nsopw",
          "name": "National Sex Offender Public Website"
        }
      ],
      "stateData": {
        "status": "Active",
        "designation": "Sexually Violent Offender",
        "complianceStatus": "COMPLIANT",
        "locations": [
          {
            "type": "RES (Primary)"
          }
        ]
      }
    }
  ],
  "errors": [
    {
      "code": 424,
      "message": "Some requests failed"
    }
  ],
  "error": 503
}

Changes

    • info

      added the new optional query request parameter history

    • info

      added the optional property // to the response with the status

    • info

      added the optional property to the response with the status

    5 more changes in this revision