Sex Offender Search API Documentation

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

The standard endpoint is not intended for PHI/ePHI workflows. Approved Enterprise HIPAA/BAA workflows use a dedicated account-enabled access path with header authentication and require an executed Business Associate Agreement (BAA). Contact us for details.

Standard API access is not intended for FCRA-regulated workflows. Approved CRA and Enterprise partners use dedicated, separately enabled access under a written agreement, approved business verification and permissible purpose, and agreed scope. Contact us for details.

Send your API key in X-API-Key or Authorization: Bearer, and send search fields in a JSON body. This keeps credentials and search parameters out of browser history, referrers, screenshots, and many logging systems.

The same fields listed in Query Parameters can be sent as JSON properties in POST requests. For compatibility, the standard endpoint also accepts key in the JSON body; the production example above uses headers. GET requests remain supported for demos and compatibility. Approved Enterprise HIPAA/BAA workflows see a separate documented path with a JSON body. Contact us for details.

Use a returned record uuid to retrieve History as JSON or download a printable PDF report. Both endpoints are available to all API accounts. See the Sex Offender History API documentation.

//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",
      "dobPrecision": "exact",
      "address": "10000 San Francisco Way",
      "city": "San Francisco",
      "state": "California",
      "zipcode": "94104",
      "locations": [
        {
          "type": "R",
          "streetAddress": "10000 San Francisco Way",
          "city": "San Francisco",
          "county": "San Francisco",
          "state": "CA",
          "zipCode": "94104",
          "latitude": 50.12345,
          "longitude": -34.67890
        },
        {
          "type": "E",
          "streetAddress": "200 FL DRIVE",
          "city": "Miami",
          "county": "Miami-Dade",
          "state": "FL",
          "zipCode": "33129",
          "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)\ntattoo on l_arm (portrait)",
      "riskLevel": "2",
      "crime": "14:81 - Indecent Behavior with Juveniles\n314 - Indecent Exposure",
      "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",
      "personUuid": "83425e56-2c6e-5e90-a86f-d4e607a39c85",
      "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"],
        "marks": "TAT R ARM\nSC L KNEE",
        "photos": [{"url":"https://example.gov/photo/123","date":"2025-01-15"}],
        "initialRegistrationDate": "2000-12-19",
        "lastVerificationDate": "2026-02-20",
        "judgmentOfConvictionUrl": "https://sexoffenders.ehawaii.gov/coveredoffender/resource/A3005425__QA.pdf",
        "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"

curl -X POST "https://api.offenders.io/sexoffender" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
  -H "X-Request-Id: 550e8400-e29b-41d4-a716-446655440000" \
  --data '{"firstName":"Alice","lastName":"Smith","fuzzy":true}'

# Bearer token form also works:
# -H "Authorization: Bearer YOUR_KEY"

Ready to integrate?

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