Retrieve known sex offender history by exact identifier

Changed on

History is available to all API accounts; normal authentication and usage rules apply. Send a record uuid. Results are returned from newest to oldest, with up to 50 records per page. Record links do not confirm identity; verify important details with the official registry. For a printable PDF of available History, use /sexoffender/report/history with the same uuid and API key.

get/sexoffender/history

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. Header authentication is recommended.

uuidstring uuid required

Record UUID returned by Search.

pageinteger

Page number. The server returns 50 records per page.

Headers

X-Request-Idstring

Optional opaque client correlation ID.

Response

Known records connected to the record UUID

pageinteger required
totalPagesinteger required

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)"
          }
        ]
      }
    }
  ]
}

Changes

    • info

      response property offenders/items/content deprecated

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    4 more changes in this revision