Re-open a past search's stored results

Changed on

Returns the records a past search on this account returned, exactly as they were returned. It does not run the search again and is not billed. Results are kept for the account's retention window (retentionDays) and then erased.

get/v1/searches/{searchId}/results

Request

  • Base URL: https://api.offendersearch.app
  • URL: https://api.offendersearch.app/v1/searches/{searchId}/results
  • Auth: API key in header X-API-Key

Path parameters

searchIdstring required

Response

The stored results.

searchIdstring
ranAtstring date-time

When the search ran.

statusstring nullable

The search's status when it ran.

queryobject

The query that was sent, with empty fields removed.

storedCountinteger

Records filed with the search.

totalCountinteger

Records the search matched.

retentionDaysinteger

How many days results are kept.

Example response

{
  "records": [
    {
      "recordId": "rec_ab12cd34ef56gh78ij90",
      "personRef": "prs_3c9e1f0a7b2d4e6f8a1b",
      "uuid": "IL:X24A0926",
      "matchDetail": {
        "strategies": {
          "lastName": "exact",
          "firstName": "nickname"
        },
        "fieldsPresent": [
          "lastName",
          "firstName",
          "dob"
        ]
      },
      "nicknames": [
        "john",
        "johnny",
        "jack"
      ],
      "birthYear": 1976,
      "marks": "Tattooed Arm, left upper; Scar on Chest; Pierced ear, left",
      "addresses": [
        {
          "type": "residence"
        }
      ],
      "registrationState": "FL",
      "addressStates": [
        "FL",
        "GA"
      ],
      "stateData": {
        "shoeSize": "10½",
        "build": "Large",
        "shoeWidth": "D"
      },
      "source": {
        "jurisdiction": "IL",
        "personRef": "prs_3c9e1f0a7b2d4e6f8a1b"
      },
      "sources": [
        {
          "jurisdiction": "IL",
          "personRef": "prs_3c9e1f0a7b2d4e6f8a1b"
        }
      ],
      "clearance": {
        "clearanceId": "clr_7d2f41c0a9b3e8f6"
      }
    }
  ]
}

Changes