API Documentation

• Base URL
• Authentication
• Search Modes
• Fuzzy Matching
• Query Parameters
• Response Fields
• stateData Schema
• Result Limits
• Error Handling
• Code Examples

//Response
{
  "offenders": [
    {
      "name": "First M Last",
      "firstName": "First",
      "firstName_nicknames": ["firsty", "firs", "1st"],
      "lastName": "Last",
      "aliases": [
        {
          "prefix": null,
          "givenName": "FIR",
          "middleName": null,
          "surName": "ST",
          "suffix": null
        },
        {
          "prefix": null,
          "givenName": "FIRST",
          "middleName": "M",
          "surName": "LA",
          "suffix": null
        },
        {
          "prefix": null,
          "givenName": "FIRST",
          "middleName": "NONAME",
          "surName": "LAST",
          "suffix": null
        },
        {
          "prefix": null,
          "givenName": "X",
          "middleName": null,
          "surName": "THE X",
          "suffix": null
        }
      ],
      "dob": "1900-10-01T00:00:00.000Z",
      "address": "10000 San Francisco Way",
      "city": "San Francisco",
      "state": "California",
      "zipcode": "94104",
      "locations": [
        {
          "name": null,
          "type": "R",
          "streetAddress": "10000 San Francisco Way",
          "city": "San Francisco",
          "county": "California",
          "state": "CA",
          "zipCode": "94104",
          "zipCodeExtension": null,
          "latitude": 50.12345,
          "longitude": -34.67890
        },
        {
          "name": null,
          "type": "E",
          "streetAddress": "200 FL DRIVE",
          "city": "Miami",
          "county": "Miami-Daide",
          "state": "FL",
          "zipCode": "33129",
          "zipCodeExtension": null,
          "latitude": 34.67890,
          "longitude": -50.12345
        }
      ],
      "sex": "Male",
      "age": "123",
      "offenderUrl": "https://meganslaw.ca.gov/OffenderDisplay.aspx?search...",
      "offenderImageUrl": "https://meganslaw.ca.gov/NSOPWPI.ashx?f=...&NSOPRFlag=True",
      "jurisdiction": "CA",
      "isAbsconder": false,
      "isPredator": true,
      "eyeColor": "Green",
      "hairColor": "Brown",
      "height": "5'11\"",
      "weight": "200 lbs.",
      "race": "White",
      "marks": "tattoo on r_arm (cross / cover the cross with tribal symbol); tattoo on l_arm (pic of a lady); tattoo on l_arm (something); ...",
      "riskLevel": "2",
      "crime": "Crime:  14:81 - Indecent Behavior with Juveniles; Juvenile victim, Conviction date:  2199-09-09, Jurisdiction:  California",
      "registrationDate": "2012-12-31T00:00:00.000Z",
      "content": "<br><b>Zip Code: </b>94104<br><b>Sex: </b>Male<br><b>Age: </b>123...",
      "lat": 50.12345,
      "lng": -34.67890,
      "sources": [
        {
          "name": "National Sex Offender Public Website",
          "id": "nsopw",
          "url": "https://www.nsopw.gov/"
        },
        {
          "name": "New York State Division of Criminal Justice Services",
          "id": "criminaljustice.ny.gov",
          "url": "https://www.criminaljustice.ny.gov/"
        }
      ],
      "updatedAt": "2026-03-05T21:35:42.936Z",
      "uuid": "5893a310-37ce-58d8-b101-39e76a60e94a",
      "stateData": {
        "stateOffenderId": "SO-123456",
        "status": "Active",
        "designation": "Sexually Violent Offender",
        "offenses": [
          {
            "offense": "AGGRAVATED SEXUAL BATTERY",
            "convictionDate": "11/04/1999",
            "statute": "18.2-67.3",
            "jurisdiction": "Richmond Circuit",
            "victimAge": "Unknown"
          }
        ],
        "aliases": ["JOHN A DOE", "JOHNNY DOE"],
        "initialRegistrationDate": "2000-12-19",
        "lastVerificationDate": "2026-02-20",
        "complianceStatus": "COMPLIANT",
        "isLifetimeRegistration": true,
        "incarcerationStatus": "On Parole",
        "lawAgency": "RICHMOND POLICE DEPT",
        "vehicles": [{"plate":"ABC1234","make":"Toyota","year":"2015"}],
        "victimInfo": [{"gender":"Female","minor":true}]
      }
    }
  ]
}

Higher limits for name searches can be enabled at no extra cost. All results are returned in a single API call. Contact us to enable this for your account.

const res = await fetch(
  `https://api.offenders.io/sexoffender?key=${API_KEY}&zipcode=94104`
)
const { offenders } = await res.json()
console.log(offenders[0].name, offenders[0].city)

import requests

r = requests.get("https://api.offenders.io/sexoffender", params={
    "key": API_KEY,
    "firstName": "Alice",
    "zipcode": "94104"
})
offenders = r.json()["offenders"]

curl "https://api.offenders.io/sexoffender?key=YOUR_KEY&lat=30.967&lng=-91.116&radius=2"

Ready to integrate?

Get your free API key and start making calls in minutes — via REST API or MCP server.