OffenderSearch
Sex offender API · pay per call

The sex offender API, 58 US registries in one call.

Send a name and a date of birth to POST /v1/search; get scored, cited registry records back from 57 US registries in one JSON response. $0.15 a call, 25 free, no card.

Get a free API keyRead the docs25 free calls · no card
57 registries in one request50 states, DC and 5 territories plus the national site and the tribal registries$0.15 a call25 free calls, then the sandbox for testing

Updated November 8, 2026 · API changelog

Part of the background check API; jail, court and prison records come from the criminal records API on the same key.

POST /v1/search · sandbox
curl -X POST "https://sandbox.offendersearch.app/v1/search" \
  -H "X-API-Key: $OFFENDERSEARCH_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "query": {
        "firstName": "Exact",
        "lastName": "Match",
        "dob": "1980-01-01"
      }
    }'
One strong match: DOB-verified (matchState dob_match), high confidence, photo, offense, registry state and two addresses.Sandbox people are synthetic; production answers have the same shape.

What comes back from a sex offender API search

The complete captured answer for the sandbox's date-of-birth-verified person, each field explained beside it, then the shape of a clear.

200 OK · scenario “Exact match, date of birth verified” · query {"firstName":"Exact","lastName":"Match","dob":"1980-01-01"} · click to fold
{
  "searchId": "srch_sbx_so_exact",
  "status": "complete",
  "elapsedMs": 236,
  "counts": {
    "records": 1,
    "sourcesQueried": 58,
    "sourcesIncomplete": 0,
    "sourcesComplete": 58,
    "sourcesSkippedByScope": 0,
    "recordsReturned": 1
  },
  "capped": false,
  "cappedReason": null,
  "cappedLimit": null,
  "cappedOmittedSources": [],
  "omittedFields": [],
  "page": 1,
  "perPage": 1,
  "totalPages": 1,
  "proof": {
    "status": "none"
  },
  "warnings": [],
  "sourceStatus": [
      {
          "source": "AK",
          "status": "complete",
          "matched": 0,
          "fromCache": true,
          "note": null,
          "incomplete": false,
          "incompleteReason": null,
          "cappedOmitted": false
      },
      {
          "source": "OH",
          "status": "complete",
          "matched": 1,
          "fromCache": true,
          "note": null,
          "incomplete": false,
          "incompleteReason": null,
          "cappedOmitted": false
      },
    /* … 56 more rows, every one "status": "complete", "matched": 0 */
  ],
  "records": [
    {
      "recordId": "rec_28db9639d712c4c61e8e",
      "personRef": "prs_28db9639d712c4c61e8e",
      "uuid": "SBX-OH-100001",
      "recordType": "sex_offender",
      "matchConfidence": 0.9,
      "matchBasis": [
        "lastName",
        "firstName",
        "dob",
        "lastName:exact",
        "firstName:exact",
        "name_match"
      ],
      "matchDetail": {
        "strategies": {
          "lastName": "exact",
          "firstName": "exact"
        },
        "fieldsPresent": [
          "lastName",
          "firstName",
          "dob"
        ],
        "signals": [
          "matchedLegalName"
        ],
        "matchedNameType": "legal",
        "verification": "dob_match"
      },
      "matchedName": {
        "value": "Exact Sample Match",
        "type": "legal"
      },
      "name": {
        "first": "Exact",
        "middle": "Sample",
        "last": "Match",
        "suffix": "",
        "full": "Exact Sample Match"
      },
      "aliases": [],
      "nicknames": [],
      "dob": "1980-01-01",
      "birthYear": 1980,
      "dobPrecision": "exact",
      "age": "46",
      "sex": "M",
      "race": "White",
      "ethnicity": "Not Hispanic",
      "height": "5'10\"",
      "weight": "180 lbs",
      "eyeColor": "Brown",
      "hairColor": "Brown",
      "marks": "Tattoo, left forearm (sample)",
      "addresses": [
        {
          "type": "residence",
          "line1": "100 Sample St",
          "city": "Sampleville",
          "county": "Sample",
          "state": "OH",
          "zipcode": "00000",
          "lat": null,
          "lng": null
        },
        {
          "type": "employment",
          "line1": "200 Example Ave",
          "city": "Sampleville",
          "county": "Sample",
          "state": "OH",
          "zipcode": "00000",
          "lat": null,
          "lng": null
        }
      ],
      "registrationState": "OH",
      "addressStates": [
        "OH"
      ],
      "offense": {
        "crime": "Sexual battery",
        "statute": "SAMPLE 2907.03",
        "tier": "Tier III",
        "convictionDate": "2004-05-12",
        "offenseDate": "2003-11-02",
        "registrationDate": "2008-02-01",
        "releaseDate": "2008-01-15",
        "caseNumber": "SBX-2003-000101",
        "victimAge": "Minor",
        "convictionCounty": "Sample"
      },
      "offenses": [
        {
          "crime": "Sexual battery",
          "statute": "SAMPLE 2907.03",
          "tier": "Tier III",
          "convictionDate": "2004-05-12",
          "offenseDate": "2003-11-02",
          "registrationDate": "2008-02-01",
          "releaseDate": "2008-01-15",
          "caseNumber": "SBX-2003-000101",
          "victimAge": "Minor",
          "convictionCounty": "Sample"
        }
      ],
      "stateData": {
        "status": "Active",
        "designation": "Tier III sex offender",
        "lawAgency": "Sample County Sheriff's Office",
        "complianceStatus": "compliant",
        "isLifetimeRegistration": true,
        "lastVerificationDate": "2026-09-01",
        "registrationDuration": "Lifetime"
      },
      "flags": {
        "absconder": false,
        "predator": false
      },
      "images": [
        {
          "url": "https://sandbox.offendersearch.app/v1/sandbox/photos/1.svg"
        }
      ],
      "housingStatus": "housed",
      "source": {
        "jurisdiction": "OH",
        "registryName": "Sandbox sample registry (OH)",
        "recordUrl": "https://offendersearch.app/docs/sandbox",
        "personRef": "prs_28db9639d712c4c61e8e",
        "recordedAt": "2025-01-10T00:00:00+00:00",
        "lastCheckedAt": "2026-10-01T00:00:00+00:00",
        "sourceUpdatedAt": "2026-10-01T00:00:00+00:00"
      },
      "sources": [
        {
          "jurisdiction": "OH",
          "registryName": "Sandbox sample registry (OH)",
          "recordUrl": "https://offendersearch.app/docs/sandbox",
          "personRef": "prs_28db9639d712c4c61e8e",
          "recordedAt": "2025-01-10T00:00:00+00:00",
          "lastCheckedAt": "2026-10-01T00:00:00+00:00",
          "sourceUpdatedAt": "2026-10-01T00:00:00+00:00"
        }
      ],
      "dobVerification": "dob_match",
      "matchState": "dob_match",
      "unverified": false
    }
  ]
}
FieldTypeWhat it tells you
matchStateenumHow the birth information verified: dob_match, year_match, age_match, no_dob_age_year; null when the request sent no date of birth
matchConfidence0–1How much identity evidence the record carries. You choose the threshold; the sample scores 0.9 on name plus date of birth
matchBasis · matchDetailarray · objectWhich fields agreed and by which strategy (exact, nickname, prefix, fuzzy, alias); matchedName.type says whether a legal name or an alias matched
unverifiedboolTrue when no birth information confirmed the person. A name-only hit on a common surname is a lead, never an identification
dobPrecisionenumexact, year_month, year or unknown: how much of the date the registry publishes
offenses[]arrayEvery offense with crime, statute, tier, conviction and offense dates, case number and victim age where the registry publishes them
stateDataobjectRegistry-specific fields kept as published: status, designation, compliance status, last verification date, registration duration
addresses[]arrayTyped residence, employment and school addresses with county and coordinates where geocoded; addressStates lists the states they fall in
registrationStatecodeThe registry that holds the person, which can differ from where they live; query.state filters on residence and never on this
housingStatusenumhoused, homeless or incarcerated, normalised from the different ways registries write it
flags · images[]object · arrayAbsconder and predator flags where published, and the registry photographs so a reviewer can compare a face
sources[]arrayJurisdiction, registry name, the registry’s own recordUrl, lastCheckedAt and sourceUpdatedAt: the citation you keep beside a decision
personRefidA stable reference to the person that survives a registry re-issuing its own record id; monitors and FCRA orders use it
sourceStatus[] · countsarray · objectOne row per registry in scope. sourcesComplete below sourcesQueried means the answer is a lower bound, and status says partial
Every key is present on every record; test the value, not the key. The fold in the JSON names the 56 identical complete rows it hides.Record object reference ›
200 OK · scenario “Clear visitor” · query {"firstName":"Clear","lastName":"Visitor"} · click to open
{
  "searchId": "srch_sbx_so_clear",
  "status": "complete",
  "elapsedMs": 0,
  "counts": {
    "records": 0,
    "sourcesQueried": 58,
    "sourcesIncomplete": 0,
    "sourcesComplete": 58,
    "sourcesSkippedByScope": 0,
    "recordsReturned": 0
  },
  "capped": false,
  "cappedReason": null,
  "cappedLimit": null,
  "cappedOmittedSources": [],
  "omittedFields": [],
  "page": 1,
  "perPage": 0,
  "totalPages": 1,
  "proof": {
    "status": "none"
  },
  "warnings": [],
  "sourceStatus": [
    {
      "source": "AK",
      "status": "complete",
      "matched": 0,
      "fromCache": true,
      "note": null,
      "incomplete": false,
      "incompleteReason": null,
      "cappedOmitted": false
    },
    /* … 57 more rows, all "complete" */
  ],
  "records": []
}

A clear and a hit share one envelope. Only records and counts.records differ; sourceStatus still carries a row per registry, which is what lets software trust an empty list. Read status first: partial means a registry did not answer and the list is a lower bound. The other test people are on the sandbox page.

How matchState and matchBasis explain a registry match

Three match modes you choose, and two fields on every record that say how the person was identified, so a shared name never reads as a match on its own.

strict

Exact names only. Surname and given name must equal what you sent. For automated accept with no reviewer.

balanced

Nicknames, variants, initials, one-letter typos. The default. A first name of Bob finds Robert; the surname stays exact; an age is compared within ageTolerance, one year unless you change it.

broad

Prefix and typo on the surname as well. For a reviewer who would rather see too much than too little.

onAgeMismatch

drop or flag. A record whose published age contradicts the date of birth you sent is dropped by default; send flag and it returns labelled age_mismatch.

Send a date of birth whenever you hold one: a common name stops matching everyone who shares it, and a record moves from a lead to an identification. The rules in full: matching and scoring.

matchStateBirth informationWhat most teams do
dob_matchFull date of birth agreed with the registry recordAct on it
year_matchThe registry publishes a birth year only, and it agreedReview
age_matchThe registry publishes an age, within ageToleranceReview, compare the photo
no_dob_age_yearThe registry publishes no birth information; name onlyReview, compare the photo
age_mismatchThe published age contradicts the date of birth you sentDropped unless onAgeMismatch is flag
nullYou sent no date of birth; nothing could verifyTreat as a lead; unverified is true

matchBasis

lastName:exact firstName:exact dob name_match

matchDetail.strategies

Per field: exact, nickname, prefix, fuzzy or alias, so a reviewer sees why “Jordy” matched “Jordan”.

Your line

Auto-accept dob_match above the matchConfidence you set; everything else goes to a person.

How a sex offender registry search works in three steps

From an empty account to a production key, with the time each step takes.

01

Create a key

Sign up for a business account and create a key; it answers production searches at once, 25 free. A sandbox test key is minted in the same dashboard. About thirty seconds.

02

Send one POST to /v1/search

Name plus date of birth in query, the key in X-API-Key. Read status, counts and sourceStatus before the records. Under a minute with the request above.

03

Route by matchState and go live

Act on dob_match above your own confidence line, send the rest to a reviewer, keep sources[].recordUrl with the decision. Sandbox and production share one response shape, so the switch is the host name.

Search byUse it whenRequest body
Name and date of birthA known person: applicant, resident, volunteer, patient.{ "query": { "firstName": "Exact", "lastName": "Match", "dob": "1980-01-01" } }
Name and approximate ageAn age but no full birth date.{ "query": { "firstName": "Name", "lastName": "Only", "age": 46, "ageTolerance": 2 } }
Name and state of residenceA common name narrowed to people living in one state; the search still runs across the roster.{ "query": { "firstName": "Out", "lastName": "State", "state": "TX" } }
Address or ZIPWho is registered at or near a property.{ "query": { "address": "100 Sample St", "zipcode": "43215" } }
Coordinates and radiusRegistrants around a school, facility or listing, up to 100 miles.{ "query": { "lat": 40.1, "lng": -83.0, "radiusMiles": 1, "perPage": 200 } }
Selected registriesOnly some registries, with the skipped ones counted.{ "query": { "firstName": "Multi", "lastName": "State" }, "jurisdictions": ["FL", "GA"] }

The bodies above use the sandbox’s documented people. Pagination with page and perPage: pagination · keys and headers: authentication · the five-minute version: quickstart.

The 57 registries one sex offender API call searches

50 state registries, DC, 5 territories, the national public site and the tribal registries, listed from the catalogue the search fans out to. Omit jurisdictions and all of them run; name some and the rest are counted as skipped.

CodeRegistryScope
NSOPWNSOPW (National Sex Offender Public Website)National site
ALAlabama Sex Offender Registry (ALEA)State
AKAlaska Sex Offender/Child Kidnapper Registry (DPS)State
AZArizona Sex Offender InfoCenter (DPS)State
ARArkansas Sex Offender Registry (ACIC)State
CACalifornia Megan's Law (DOJ)State
COColorado Sex Offender Registry (CBI)State
CTConnecticut Sex Offender Registry (DESPP)State
DEDelaware Sex Offender Registry (DSP)State
DCDC Sex Offender Registry (MPD)District
FLFlorida Sexual Offenders & Predators (FDLE)State
GAGeorgia Sex Offender Registry (GBI)State
HIHawaii Sex Offender Registry (AG)State
IDIdaho Sex Offender Registry (ISP)State
ILIllinois State Police Sex Offender RegistryState
INIndiana Sex & Violent Offender RegistryState
IAIowa Sex Offender Registry (DPS)State
KSKansas Offender Registry (KBI)State
KYKentucky Sex Offender Registry (KSP)State
LALouisiana State Sex Offender RegistryState
MEMaine Sex Offender Registry (SBI)State
MDMaryland Sex Offender Registry (DPSCS)State
MAMassachusetts SORBState
MIMichigan Public Sex Offender RegistryState
MNMinnesota Predatory Offender Registry (BCA)State
MSMississippi Sex Offender Registry (DPS)State
MOMissouri Sex Offender Registry (MSHP)State
MTMontana Sexual & Violent Offender Registry (DOJ)State
NENebraska Sex Offender Registry (NSP)State
NVNevada Sex Offender Registry (DPS)State
NHNew Hampshire Sex Offender Registry (DOS)State
NJNew Jersey Sex Offender Internet RegistryState
NMNew Mexico Sex Offender Registry (DPS)State
NYNew York Sex Offender Registry (DCJS)State
NCNorth Carolina Sex Offender Registry (SBI)State
NDNorth Dakota Sex Offender Registry (BCI)State
OHOhio eSORN (AG)State
OKOklahoma Sex Offender Registry (DOC)State
OROregon Sex Offender Registry (OSP)State
PAPennsylvania Megan's Law (PSP)State
RIRhode Island Sex Offender RegistryState
SCSouth Carolina Sex Offender Registry (SLED)State
SDSouth Dakota Sex Offender Registry (DCI)State
TNTennessee Sex Offender Registry (TBI)State
TXTexas DPS Sex Offender RegistryState
UTUtah Sex & Kidnap Offender Registry (DPS)State
VTVermont Sex Offender Registry (VCIC)State
VAVirginia Sex Offender Registry (VSP)State
WAWashington State Sex Offender Registry (WASPC)State
WVWest Virginia Sex Offender Registry (WVSP)State
WIWisconsin Sex Offender Registry (DOC)State
WYWyoming Sex Offender Registry (DCI)State
PRPuerto Rico Sex Offender RegistryTerritory
GUGuam Sex Offender RegistryTerritory
USVIUS Virgin Islands Sex Offender RegistryTerritory
ASAmerican Samoa Sex Offender Registry (TTSORS)Territory
CNMIN. Mariana Islands Sex Offender Registry (TTSORS)Territory
The codes are the values jurisdictions and sourceStatus[].source use.Jurisdictions reference ›
sourceStatus · the captured “Exact match” search57 queried · 57 complete · 1 matched
NSOPW 0AL 0AK 0AZ 0AR 0CA 0CO 0CT 0DE 0DC 0FL 0GA 0HI 0ID 0IL 0IN 0IA 0KS 0KY 0LA 0ME 0MD 0MA 0MI 0MN 0MS 0MO 0MT 0NE 0NV 0NH 0NJ 0NM 0NY 0NC 0ND 0OH 1OK 0OR 0PA 0RI 0SC 0SD 0TN 0TX 0UT 0VT 0VA 0WA 0WV 0WI 0WY 0PR 0GU 0USVI 0AS 0CNMI 0

One chip per registry: its code and matched. All 57 are drawn, none folded; Ohio holds the sample person.

Registries publish differently: a full date of birth or only an age, a tier or a designation, a vehicle list or none. dobPrecision and stateData keep those differences inside the one schema, and GET /v1/sources publishes each registry’s scope and health. Field rates by registry: data coverage; the national public website: NSOPW API.

Is a sex offender API result a consumer report?

Not from the standard key. The same records can be furnished under FCRA Partner Access when a hiring, housing, credit or insurance decision depends on them.

Path 1

Data API, not FCRA

$0.15a call, 25 free, no card
  • For: visitor and volunteer screening, trust and safety, research, monitoring, and software that shows a public record to the person who asked for it.
  • Must not decide: whether someone is hired, housed, insured or given credit. The response is a public-records lookup, not a consumer report, and the key is not approved for those uses.
  • Example: An admissions desk screens a visitor against the registries before a visit; no hiring, housing or credit decision is involved.

Self-serve: get a key, then POST /v1/search or /v1/criminal/search.

Path 2

FCRA Partner Access

$4.95per order, searches and live checks included, no court fees
  • Built in: end-user registration with a permissible purpose, consent on every order, the pre-adverse and adverse-action notices with the consumer’s copy, and a consumer portal.
  • Disputes: a dispute endpoint; the record is re-checked with the registry or court that holds it, with an outcome inside 30 days, and a correction reaches every partner that received it.
  • Example: A screening company furnishes a report an employer or landlord will act on; the order runs the consent, notice and dispute steps.

Under a written agreement: Request FCRA Partner Access.

The records can be the same; the process around them is not. How the program works: FCRA Partner Access · the orders endpoint: FCRA orders API · reference and statute citations: FCRA docs. This page describes the product, not legal advice.

Sex offender API pricing per call and per monitor

One metered rate for a registry search, a lower rate past the monthly threshold, and monthly watches. Nothing else is required to run a search.

ItemPriceUnit
Registry search$0.15per call, the first 2,000 in a calendar month
Volume rate$0.11per call past 2,000 in a calendar month
Free to start25 callsonce per account, on production data, no card
Sandbox$060 calls a minute and 2,000 a day per test key
Person monitor$3.00per person a month
Location monitor$10.00per location a month

No minimum on search. The Map API has its own $300 monthly minimum. No seats, no platform fee, no per-state fee; a batch row is billed as one call.

Monthly calls:
$1,180
a month
$0.118
effective per call
8,000
calls at $0.11

The first 2,000 calls in a calendar month are $0.15 each, every one after that $0.11. The 25 free calls on a new account are not subtracted here. Live re-verification, monitors and FCRA orders are billed separately.

Watch a person for $3 a month or a location for $10; a monitor replaces the monthly re-run of a roster and alerts by signed webhook or email. Registry watches: sex offender monitoring; the same watch over jail, court and prison records: continuous criminal monitoring API. A criminal search on the same key is billed as its own call.

Worked examples by volume: background check API pricing · every rate: pricing.

Where a sex offender registry check sits in software

Three placements, each with the one field or call that differs.

Front-desk visitor screening

One call per check-in with a name and date of birth.

What differs: counts.sourcesComplete equal to sourcesQueried before a clear is shown.

Visitor management systems ›

Marketplace and gig onboarding

Check at sign-up, then watch the people who stay instead of re-running the search.

What differs: a POST /v1/monitors person watch; a new record arrives as a signed webhook.

Gig platforms and marketplaces ›

Property and tenant workflows

Who is registered near a listing is a data-API question; whether to rent to an applicant is an FCRA order.

What differs: the FCRA sex offender check API for the application, the radius search for the listing.

Property management ›

Sex offender API comparison with Checkr and SearchBug

Published facts only, each cell from the vendor's own pages on the date in the footnote; rows where another vendor does more are kept.

AspectCheckrSearchBugOffenderSearch API
What you pay forA finished consumer report, per report, by package; court and database fees passed through at costPrepaid balance of $10 to $5,000, charged per successful query; Criminal Check priced per searchOne API call: scored public records for a name and date of birth, in the same HTTP response
Published entry price$29.99 a report (Basic)Not stated on its public pages$0.15 a call, $0.11 past 2,000 in a month
Free tierwhere another vendor does moreNo free trial listed on its pricing page; a staging environment with mocked data is available on requestA sandbox test account with "a limited number of live queries"; the number is not stated25 calls on production data, no card; the sandbox at 60 calls a minute, 2,000 a day per test key, nothing billed
When nothing is foundwhere another vendor does moreA report is billed whatever it finds"There is no charge if there is no information found on a query"; a Criminal Check that finds no record still counts as a successful queryA clear answer is a billed call: the response says which sources answered, which is the evidence a clear needs
Test environmenta staging environment with mocked data, available once Checkr grants access (api.checkr-staging.com)Sandbox API test account on requestSelf-serve sandbox with documented test people; mint an os_test_ key in the dashboard
Rate limit1,200 requests a minute across all endpoints; 429 with X-Ratelimit-Limit, -Remaining and -Reset headersNot stated on its public pagesNo published per-key ceiling in production; a 429 with Retry-After only at capacity, never billed
Webhookswebhooks signed with HMAC-SHA256 in an X-Checkr-Signature header; retries every minute for 10 minutes, then every hour for 24 hoursNot stated on its public pagesAsync searches post the finished envelope to a webhookUrl; monitor and FCRA deliveries carry X-Offendersearch-Signature (HMAC-SHA256 over t.body), are retried and can be replayed
Continuous monitoringCheckr offers continuous criminal search at $1.70 per individual a month and continuous MVR at $2.50 per driver a monthNot stated on its public pages$3.00 a month per person, $10.00 per location, alerts by signed webhook
FCRA consumer reportsYes: every report is a consumer report, $29.99 to $94.99 by packageNot stated on its public pagesThrough FCRA Partner Access: $4.95 an order, searches and live checks included, no court fees

Checkr: checkr.com/pricing and docs.checkr.com, read 2026-11-08. SearchBug: searchbug.com/pricing-api.aspx, read 2026-11-08. Each vendor’s pages are the authority on its product and change without notice; a blank is a fact the vendor does not publish, not a zero. A consumer report and a public-records lookup are different products.

Developer resources for the sex offender registry API

The contract, the collection, the agent tooling and the test surfaces.

OpenAPI document ›Every endpoint, schema and enum; generate a typed client.
POST /v1/search reference ›Request body, response keys, errors.
Postman collection ›Sandbox environment, bodies pre-filled.
MCP server ›The search as a tool for Claude, Cursor and other agents.
llms.txt ›The index a coding agent reads first.
API changelog ›Behaviour changes, dated.
Sandbox ›60 calls a minute, 2,000 a day per test key.
Webhook tester ›Shows and verifies the signed events a monitor sends.
Batch endpoint ›Up to 1,000 people a request, one scored row each.
Async searches ›A searchId at once, the answer by webhook or poll.
Python and Node clients ›offendersearch and @offendersearch/sdk publish with the first registry release; until then the REST calls above are the integration.
Bulk sex offender search ›A CSV in, one scored row per person out.

Sex offender API rate limits and what it does not return

The edges of one key, a real rate-limit body, and what is out of scope.

LimitValue
Sandbox, per test key60 calls a minute, 2,000 a day; nothing billed
Production, per keyNo published ceiling. A 429 only when the service is at capacity, with Retry-After; a 429 is never billed
Records per responseUp to 4,000 in one answer; above that capped: true, and perPage pages through the rest
Batch1,000 rows a call; a failing row is reported in place and never stops the batch
DeadlinedeadlineMs bounds the wait for slow jurisdictions; an unanswered one is named in sourceStatus and the answer says partial
EndpointsPOST /v1/search; one X-API-Key header
  • No civil cases, no traffic citations. Criminal records only: jail bookings, prison custody, court cases with dispositions, warrants, and the registries.
  • No international records. US county, state and federal sources, and the 58 US registries.
  • Not a consumer report. A hiring, housing, credit or insurance decision runs as an order through FCRA Partner Access, not through the standard key.
  • No SSN on the standard key, no credit, no verifications, no drug or driving records. Scope comes from the name, the date of birth and the places you already hold; only an FCRA order can trace the address history from an SSN.
  • No records from the national public website. Each registry is searched in its own right; the national site is a comparison destination, never a source.
  • No definitions of our own. Tiers, designations and flags mean what the publishing state says they mean.

Retry rules and backoff: rate limits, retries and idempotency · every status code: errors.

What a rate-limit answer looks like
HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json

{
  "detail": {
    "code": "overloaded",
    "retryAfterSeconds": 12
  }
}
Nothing was searched and nothing was billed; wait retryAfterSeconds and send the same request again.

Sex offender API questions developers ask

Scope, timeouts, clears, retention, place searches, monitoring, definitions.

Does query.state limit which registries are searched?

No. query.state keeps only people whose address is in that state; the search still runs across the roster, so someone registered by Oklahoma and living in Texas comes back. To search fewer registries, send jurisdictions; the response counts the rest in counts.sourcesSkippedByScope.

What happens when a registry does not answer in time?

deadlineMs bounds the wait. A registry that misses it is named in sourceStatus with a reason and status reads partial. If nothing matched and a registry stopped early, the default answer is 504 incomplete_no_results rather than an empty list; send onDeadline: "partial" to receive the partial body instead.

Is a search that finds nobody billed?

Yes. A complete answer with zero records is the product: 58 queried, 58 complete, none matched, with the rows to prove it. A 429, a 5xx or a refused 422 searched nothing and is never billed.

How long can I re-open a search result?

Fourteen days. GET /v1/searches/{searchId}/results returns the stored records in that window at no charge and answers 410 after it. A recordId resolves for the same period; a registry’s own uuid resolves while the registry publishes it. See result completeness.

Can I search by address or radius without a name?

Yes, once a payment method is on file; the 25 free calls need a name in every query. Address, ZIP and coordinate searches return everyone registered in the area, up to 4,000 records a response with capped set when there are more. For a drawn map view, the sex offender map API answers per map request.

How does monitoring differ from re-running the search?

A monitor is a standing watch on a person or a place: when a matching registry record appears or changes, an event is posted to your webhook, signed with X-Offendersearch-Signature, or sent by email. Registry alerts: sex offender monitoring; the same watch across jail, court and prison records: continuous criminal monitoring API.

Does the API define who is a predator or what a tier means?

No. Where a registry publishes a flag, a tier or a designation it is carried in flags, offenses[].tier and stateData; what each means is defined by that state’s law, and the record links the registry entry so a reviewer can read it there.

Sex offender API how-to guides

Runnable tutorials that use this endpoint as the worked example, each against the sandbox.

Check a registered sex offender by API ›Name plus date of birth, 58 US registries, and what each matchState means.
Background check API tutorial ›A first registry and criminal check in ten minutes, on the sandbox, in curl, Python and Node.
Background check API response explained ›Every field of a real sandbox response, group by group.
No-match and multiple-match results ›The three shapes of "nothing", possibles, and a decision table per matchState.
Monitor a person with webhooks ›A standing watch on a person, signed alerts, and the receiver that verifies them.
Test a background check integration ›The sandbox scenario matrix, a test suite, CI and the switch to production.
Rate limits, retries and idempotency ›429 semantics, backoff that honours Retry-After, and why a repeated POST is a second search.
Bulk background checks from a CSV ›The batch endpoint, 1,000 rows a call, results in input order, billed per row.

All guides: Learn APIs by example · reference: developer docs · packages: SDKs and CLI.

Related sex offender API pages

The rest of the developer surface, one anchor per page.

Background check API ›Criminal records and 58 US sex offender registries on one key, per call.
Criminal records API ›Court cases, jail bookings, prison custody and warrants as JSON.
Free background check API ›25 free calls on real data, no card, plus the free sandbox.
Employment screening API ›The public-records stage of a hiring pipeline, and the FCRA path for the decision.
Tenant screening API ›The registry and criminal layer behind a rental application.
Inmate search API ›State prison and county jail custody records.
Background check API pricing ›Costs from 100 to 100,000 searches a month.
Public API for testing ›A free sandbox with documented test people in the production shape.
SDKs: Python, Node, CLI ›Client status and the method surface, one per endpoint.
Postman collection ›Every endpoint with sandbox bodies pre-filled.
MCP server ›Registry and criminal lookups as tools for Claude, Cursor and agents.
API documentation ›Reference, guides and the OpenAPI spec.

Make the first sex offender API call today

A key in thirty seconds, 25 free calls, and one response shape from the first call to production.