# sex-offender-registry Schema: #/components/schemas/sex-offender-registry Method: SCHEMA Version: 1.0 Security: bearer-token ## Schema fields: - `id` (string) Unique identifier for the report item. Example: rpi_F3hQ7wEsLp2xBnVcRuMyTk - `status` (string | null) Resolved status of this report item: * `clear` — no findings that warrant adjudication * `consider` — something to review before making a decision. This does not necessarily mean adverse information was found. Null while the report item is still being assembled and no results have been recorded yet. Enum: "clear", "consider", null - `created_at` (string) Timestamp the report item was created. - `updated_at` (string) Timestamp the report item was last updated. - `records` (array) One entry per registry match returned for the applicant. Empty if no matches were found. - `records.source` (any) The registry or watchlist that returned the match. `null` when the upstream source returned no source metadata. - `records.source.name` (string | null) Human-readable name of the source (e.g. `California Megan's Law Registry`, `OFAC SDN`). - `records.source.category` (string | null) Category of source the match came from. Common values include `sex offender registry`, `sanctions`, `healthcare`, and similar regulatory list categories. - `records.source.county` (string | null) County the source covers, when applicable. - `records.source.state` (string | null) Two-letter USPS state code the source covers, when applicable. Example: CA - `records.person` (any) Identifying details of the matched person as recorded by the source. `null` when the upstream source returned no person details. - `records.person.full_name` (string | null) Full name as recorded by the source. - `records.person.first_name` (string | null) Given name as recorded by the source. - `records.person.middle_name` (string | null) Middle name as recorded by the source. - `records.person.last_name` (string | null) Family name as recorded by the source. - `records.person.dob` (string | null) Date of birth as recorded by the source. Returned in truncated ISO 8601 form: `YYYY-MM-DD`, `YYYY-MM`, or `YYYY` when only a partial date is known. `null` when the source does not publish a date of birth. - `records.person.gender` (string | null) Gender as recorded by the source. - `records.person.height` (string | null) Height in US units (feet and inches, e.g. `5'10"`). - `records.person.weight` (string | null) Weight in US units (pounds, e.g. `175 lb`). - `records.person.hair_color` (string | null) Hair color as recorded by the source. - `records.person.eye_color` (string | null) Eye color as recorded by the source. - `records.person.race` (string | null) Race as recorded by the source. May be withheld by source jurisdiction. - `records.person.photo_urls` (array) URLs of any photos published by the source. Empty array when none are available. - `records.person.aliases` (array) Other names the matched person is known by, as recorded by the source. - `records.person.addresses` (array) Addresses associated with the matched person, as recorded by the source. - `records.person.addresses.street` (string | null) Street line, including house/building number and street name. Apartment or unit numbers may be included. - `records.person.addresses.city` (string | null) City or municipality. - `records.person.addresses.state` (string | null) Two-letter US state code. `null` for non-US addresses. Example: CA - `records.person.addresses.zipcode` (string | null) US Postal Service ZIP code (5-digit or 9-digit ZIP+4). `null` for non-US addresses. - `records.person.addresses.country` (string | null) Two-letter ISO country code. Defaults to `US` when omitted by the source. Example: US - `records.person.addresses.county` (string | null) County the address is located in. - `records.cases` (array) Criminal cases associated with this match. Often empty for watchlist matches that do not carry court data. - `records.cases.case_number` (string | null) Court-assigned case number identifying the matter. - `records.cases.court_name` (string | null) Name of the court that handled the case. - `records.cases.county` (string | null) County the case was filed in. - `records.cases.state` (string | null) Two-letter USPS state code where the case was filed. Example: CA - `records.cases.file_date` (string | null) Date the case was filed with the court. - `records.cases.charges` (array) Charges filed under this case. - `records.cases.charges.charge` (string | null) Description of the charge as recorded by the court. - `records.cases.charges.statute` (string | null) Statute or legal code the charge was filed under. - `records.cases.charges.type` (string | null) Classification of the charge as reported by the underlying court source. Commonly one of `felony`, `misdemeanor`, `infraction`, or `violation`, but other source-specific classifications may pass through. - `records.cases.charges.offense_date` (string | null) Date the alleged offense occurred. - `records.cases.charges.charge_date` (string | null) Date the charge was filed. - `records.cases.charges.arrest_date` (string | null) The date the person was arrested. - `records.cases.charges.disposition` (string | null) The court's most recent resolution of the charge. Returns the normalized `disposition_type` value when available, otherwise the raw text as reported by the source. Charges with multiple court actions surface the latest one by `disposition_date`. - `records.cases.charges.disposition_type` (string | null) Normalized disposition category. Known values: `conviction`, `dismissed`, `expunged`, `pending`, `transferred`, `warrant`, `merged`, `invalid`, `alternative_adjudication`, `unclassified`. Additional values may be introduced over time. `null` when no normalized category could be assigned. - `records.cases.charges.disposition_date` (string | null) Date the most recent disposition was entered.