# Criminal Records API enums
> Every closed vocabulary the Criminal Records API accepts or returns, with every value and where it appears.
- **HTML:** https://offendersearch.app/docs/criminal/enums
- **OpenAPI:** https://offendersearch.app/openapi.json

Direction says whether a value is sent (request), received (response) or both. Treat an unrecognised value as `other` and log it; values are added, never removed or renamed.

| Field | Where | Direction | Values | Default |
| --- | --- | --- | --- | --- |
| `chargeCategories` | [The SearchFilters object — criminal search filter fields](https://offendersearch.app/docs/criminal/filtering#object-searchfilters) | request | `supervision` · `homicide` · `sex_offense` · `robbery` · `domestic_violence` · `dui` · `assault` · `weapons` · `burglary` · `fraud` · `theft` · `drug_distribution` · `drug_possession` · `traffic` · `public_order` · `other` | — |
| `chargeMatch` | [The SearchFilters object — criminal search filter fields](https://offendersearch.app/docs/criminal/filtering#object-searchfilters) | request | `any` · `all` | `any` |
| `clearanceMode` | [The SearchRequest object](https://offendersearch.app/docs/criminal/search#reference-post-v1-criminal-search) | request | `suppress` · `annotate` · `ignore` | `suppress` |
| `custodyStatus` | [The SearchFilters object — criminal search filter fields](https://offendersearch.app/docs/criminal/filtering#object-searchfilters) | request | `in_custody` · `released` · `on_parole` · `on_probation` · `active_warrant` · `wanted` · `registered` · `disposed` · `absconder` · `deceased` · `excluded` | — |
| `include` | [The SearchRequest object](https://offendersearch.app/docs/criminal/search#reference-post-v1-criminal-search) | request | `sourceData` · `coverage` · `exclusions` · `facets` · `normalizedDetail` | — |
| `include` | [The BatchEnvelope object](https://offendersearch.app/docs/criminal/batch#reference-post-v1-criminal-batch) | request | `sourceData` · `coverage` · `exclusions` | — |
| `kind` | [The Location object — residence and jurisdiction fields](https://offendersearch.app/docs/criminal/filtering#object-location) | request | `residence` · `jurisdiction` · `any` | `any` |
| `nameStrategy` | [The criminal Query object — every search filter](https://offendersearch.app/docs/criminal/search#object-query) | request | `prefix` · `exact` | `prefix` |
| `nameStrategy` | [The BatchEnvelope object](https://offendersearch.app/docs/criminal/batch#reference-post-v1-criminal-batch) | request | `prefix` · `exact` | — |
| `outcome` | [The SearchFilters object — criminal search filter fields](https://offendersearch.app/docs/criminal/filtering#object-searchfilters) | request | `convicted` · `pending` · `dismissed` · `nolle_prosequi` · `acquitted` · `deferred_or_diverted` · `vacated` · `warrant` · `transferred` · `closed_unspecified` · `administrative` | — |
| `recordCategory` | [The SearchFilters object — criminal search filter fields](https://offendersearch.app/docs/criminal/filtering#object-searchfilters) | request | `court` · `jail` · `prison` · `warrant` · `registry` · `exclusion` · `other` | — |
| `scope` | [The LiveRequest object — the live block](https://offendersearch.app/docs/criminal/async#object-liverequest) | request | `matched` | — |
| `severity` | [The SearchFilters object — criminal search filter fields](https://offendersearch.app/docs/criminal/filtering#object-searchfilters) | request | `felony` · `misdemeanor` · `infraction` | — |
| `severityBasis` | [The SearchFilters object — criminal search filter fields](https://offendersearch.app/docs/criminal/filtering#object-searchfilters) | request | `published` · `statute_code` · `statute_table` · `case_type` · `charge_text` | — |
| `sort` | [The SearchRequest object](https://offendersearch.app/docs/criminal/search#reference-post-v1-criminal-search) | request | `relevance` · `offenseDate` · `filedDate` · `dispositionDate` | `relevance` |
| `unknown` | [The SearchFilters object — criminal search filter fields](https://offendersearch.app/docs/criminal/filtering#object-searchfilters) | request | `keep` · `exclude` | `keep` |
| `answeredFrom` | [The criminal SourceStatus object — one live source](https://offendersearch.app/docs/criminal/result-completeness#object-sourcestatus) | both | `on_file` | — |
| `caseClass` | [The NormalizedCase object — case stage and class](https://offendersearch.app/docs/criminal/normalized-fields#object-normalizedcase) | both | `felony` · `misdemeanor` · `traffic` · `infraction` · `civil` · `unknown` | — |
| `category` | [The NormalizedCharge object — charge severity and outcome](https://offendersearch.app/docs/criminal/normalized-fields#object-normalizedcharge) | both | `supervision` · `homicide` · `sex_offense` · `robbery` · `domestic_violence` · `dui` · `assault` · `weapons` · `burglary` · `fraud` · `theft` · `drug_distribution` · `drug_possession` · `traffic` · `public_order` · `other` | — |
| `chargeCategories` | [The Normalized object — normalized criminal record fields](https://offendersearch.app/docs/criminal/normalized-fields#object-normalized) | both | `supervision` · `homicide` · `sex_offense` · `robbery` · `domestic_violence` · `dui` · `assault` · `weapons` · `burglary` · `fraud` · `theft` · `drug_distribution` · `drug_possession` · `traffic` · `public_order` · `other` | — |
| `custodyEvent` | [The NormalizedCharge object — charge severity and outcome](https://offendersearch.app/docs/criminal/normalized-fields#object-normalizedcharge) | both | `booked` · `released` · `bonded` · `held` · `transferred` | — |
| `custodyStatus` | [The Normalized object — normalized criminal record fields](https://offendersearch.app/docs/criminal/normalized-fields#object-normalized) | both | `in_custody` · `released` · `on_parole` · `on_probation` · `active_warrant` · `wanted` · `registered` · `disposed` · `absconder` · `deceased` · `excluded` · `unknown` | — |
| `dobPrecision` | [Criminal record API response fields — the CriminalRecord object](https://offendersearch.app/docs/criminal/record-object#object-criminalrecord) | both | `full` · `month_year` · `year` · `age` · `none` | — |
| `dobPrecision` | [The Dob object — birth evidence fields](https://offendersearch.app/docs/criminal/record-object#object-dob) | both | `full` · `month_year` · `year` · `age` · `none` | — |
| `dobVerification` | [Criminal record API response fields — the CriminalRecord object](https://offendersearch.app/docs/criminal/record-object#object-criminalrecord) | both | `record` · `source_confirmed` · `source_not_confirmed` · `unverified` | — |
| `dropInterpretation` | [The Lifecycle object — criminal record lifecycle fields](https://offendersearch.app/docs/criminal/record-object#object-lifecycle) | both | `released` · `source_removed` · `reinstated` · `unknown` | — |
| `error.code` | [The criminal Error object — API error response fields](https://offendersearch.app/docs/criminal/errors#object-error) | both | `no_report_input` · `not_found` · `batch_too_large` · `guard_unbounded_query` · `prefix_too_short` · `no_live_sources` · `no_website` · `bad_batch` · `empty_batch` · `query_too_broad` · `invalid_dob` · `invalid_page` · `invalid_body` · `invalid_query` · `invalid_live` · `invalid_filter_value` · `invalid_date_range` · `invalid_location` · `too_many_locations` · `ambiguous_location` · `radius_too_large` · `filters_with_async_live` · `invalid_group_by` · `invalid_parameter` · `stats_internal_only` · `unavailable` · `catalog_unavailable` · `filters_unavailable` · `stats_unavailable` · `retry` · `upstream_timeout` | — |
| `eyes` | [The Normalized object — normalized criminal record fields](https://offendersearch.app/docs/criminal/normalized-fields#object-normalized) | both | `BLK` · `BLU` · `BRO` · `GRN` · `GRY` · `HAZ` · `MAR` · `PNK` · `MUL` · `XXX` | — |
| `geoPrecision` | [The NormalizedPlace object — residence and jurisdiction](https://offendersearch.app/docs/criminal/normalized-fields#object-normalizedplace) | both | `rooftop` · `street` · `zip` · `none` | — |
| `hair` | [The Normalized object — normalized criminal record fields](https://offendersearch.app/docs/criminal/normalized-fields#object-normalized) | both | `BLK` · `BRO` · `BLN` · `RED` · `GRY` · `WHI` · `SDY` · `BLD` · `XXX` | — |
| `health.freshFor` | [The criminal SourceInfo object — one catalog row](https://offendersearch.app/docs/criminal/coverage#object-sourceinfo) | both | `daily` · `weekly` | — |
| `incompleteReason` | [The criminal SourceStatus object — one live source](https://offendersearch.app/docs/criminal/result-completeness#object-sourcestatus) | both | `captcha_unsolved` · `proxy_required` · `source_down` · `rate_limited` · `truncated_over_cap` · `paid_gateway` · `login_required` · `timeout` · `unsupported_site` · `not_searched` | — |
| `kind` | [The criminal MeterEvent object — billing events on a response](https://offendersearch.app/docs/criminal/async#object-meterevent) | both | `criminal_call` · `criminal_live_source` | — |
| `level` | [The Case object — court case fields](https://offendersearch.app/docs/criminal/record-object#object-case) | both | `county` · `state` · `federal` | `county` |
| `level` | [The criminal SourceRef object — sources[] fields](https://offendersearch.app/docs/criminal/record-object#object-sourceref) | both | `county` · `state` · `federal` | `county` |
| `level` | [The JurisdictionInfo object — one covered jurisdiction](https://offendersearch.app/docs/criminal/jurisdictions#object-jurisdictioninfo) | both | `county` · `state` · `federal` | — |
| `liveOutcome` | [The criminal SourceStatus object — one live source](https://offendersearch.app/docs/criminal/result-completeness#object-sourcestatus) | both | `captcha_unsolved` · `proxy_required` · `source_down` · `rate_limited` · `truncated_over_cap` · `paid_gateway` · `login_required` · `timeout` · `unsupported_site` · `not_searched` | — |
| `matchState` | [Criminal record API response fields — the CriminalRecord object](https://offendersearch.app/docs/criminal/record-object#object-criminalrecord) | both | `dob_match` · `year_match` · `age_match` · `no_dob_age_year` | — |
| `mode` | [The AsyncAccepted object](https://offendersearch.app/docs/criminal/search#reference-post-v1-criminal-search) | both | `async` | — |
| `omittedFields` | [The SearchResponse object](https://offendersearch.app/docs/criminal/search#reference-post-v1-criminal-search) | both | `sourceData` | — |
| `omittedFields` | [The BatchRow object — one row's result](https://offendersearch.app/docs/criminal/batch#object-batchrow) | both | `sourceData` | — |
| `outcome` | [The NormalizedCharge object — charge severity and outcome](https://offendersearch.app/docs/criminal/normalized-fields#object-normalizedcharge) | both | `convicted` · `pending` · `dismissed` · `nolle_prosequi` · `acquitted` · `deferred_or_diverted` · `vacated` · `warrant` · `transferred` · `closed_unspecified` · `administrative` · `unknown` | — |
| `outcomes` | [The Normalized object — normalized criminal record fields](https://offendersearch.app/docs/criminal/normalized-fields#object-normalized) | both | `convicted` · `pending` · `dismissed` · `nolle_prosequi` · `acquitted` · `deferred_or_diverted` · `vacated` · `warrant` · `transferred` · `closed_unspecified` · `administrative` · `unknown` | — |
| `program` | [The Exclusion object — exclusion-list record fields](https://offendersearch.app/docs/criminal/record-object#object-exclusion) | both | `medicare_medicaid` · `federal_procurement` · `state_medicaid` | — |
| `proof.status` | [The SearchResponse object](https://offendersearch.app/docs/criminal/search#reference-post-v1-criminal-search) | both | `none` | — |
| `proof.status` | [The BatchRow object — one row's result](https://offendersearch.app/docs/criminal/batch#object-batchrow) | both | `none` | — |
| `quality` | [The Normalized object — normalized criminal record fields](https://offendersearch.app/docs/criminal/normalized-fields#object-normalized) | both | `ok` · `quarantined` | — |
| `race` | [The Normalized object — normalized criminal record fields](https://offendersearch.app/docs/criminal/normalized-fields#object-normalized) | both | `W` · `B` · `I` · `A` · `H` · `U` | — |
| `recordCategory` | [Criminal record API response fields — the CriminalRecord object](https://offendersearch.app/docs/criminal/record-object#object-criminalrecord) | both | `court` · `jail` · `prison` · `warrant` · `registry` · `exclusion` · `other` | — |
| `recordCategory` | [The Normalized object — normalized criminal record fields](https://offendersearch.app/docs/criminal/normalized-fields#object-normalized) | both | `court` · `jail` · `prison` · `warrant` · `registry` · `exclusion` · `other` | — |
| `recordKind` | [The JurisdictionInfo object — one covered jurisdiction](https://offendersearch.app/docs/criminal/jurisdictions#object-jurisdictioninfo) | both | `jail-roster` · `court` · `doc-inmate` · `registry` · `warrant` · `exclusion` | — |
| `scope` | [The SearchCoverageSource object — the sources behind a search](https://offendersearch.app/docs/criminal/result-completeness#object-searchcoveragesource) | both | `county` · `state` · `federal` | — |
| `scope` | [The criminal SourceInfo object — one catalog row](https://offendersearch.app/docs/criminal/coverage#object-sourceinfo) | both | `county` · `state` · `federal` | — |
| `severity` | [The Charge object — criminal charge fields](https://offendersearch.app/docs/criminal/record-object#object-charge) | both | `felony` · `misdemeanor` · `infraction` | — |
| `severity` | [The NormalizedCharge object — charge severity and outcome](https://offendersearch.app/docs/criminal/normalized-fields#object-normalizedcharge) | both | `felony` · `misdemeanor` · `infraction` · `unknown` | — |
| `severityBasis` | [The NormalizedCharge object — charge severity and outcome](https://offendersearch.app/docs/criminal/normalized-fields#object-normalizedcharge) | both | `published` · `statute_code` · `statute_table` · `case_type` · `charge_text` | — |
| `sex` | [The Normalized object — normalized criminal record fields](https://offendersearch.app/docs/criminal/normalized-fields#object-normalized) | both | `M` · `F` · `X` · `U` | — |
| `stage` | [The NormalizedCase object — case stage and class](https://offendersearch.app/docs/criminal/normalized-fields#object-normalizedcase) | both | `open` · `closed` · `warrant` · `unknown` | — |
| `staleReason` | [The RecordClearance object — the clearance attached to a kept record](https://offendersearch.app/docs/criminal/clearances#object-recordclearance) | both | `identity_changed` · `offenses_changed` · `status_changed` · `stronger_match` | — |
| `status` | [The SearchResponse object](https://offendersearch.app/docs/criminal/search#reference-post-v1-criminal-search) | both | `complete` · `partial` | — |
| `status` | [The SearchCoverageSource object — the sources behind a search](https://offendersearch.app/docs/criminal/result-completeness#object-searchcoveragesource) | both | `live` · `pending` | — |
| `status` | [The criminal SourceInfo object — one catalog row](https://offendersearch.app/docs/criminal/coverage#object-sourceinfo) | both | `live` · `pending` | — |
| `status` | [The AsyncAccepted object](https://offendersearch.app/docs/criminal/search#reference-post-v1-criminal-search) | both | `pending` | — |
| `status` | [The JobRecord object — an async live job](https://offendersearch.app/docs/criminal/async#object-jobrecord) | both | `pending` · `complete` | — |
| `status` | [The HistoryEntry object — one prior search](https://offendersearch.app/docs/criminal/verification-reports#object-historyentry) | both | `complete` · `pending` | — |
| `status` | [The BatchRow object — one row's result](https://offendersearch.app/docs/criminal/batch#object-batchrow) | both | `complete` · `partial` · `error` | — |
| `tier` | [The JobRecord object — an async live job](https://offendersearch.app/docs/criminal/async#object-jobrecord) | both | `core` · `live` | — |
| `tier` | [The HistoryEntry object — one prior search](https://offendersearch.app/docs/criminal/verification-reports#object-historyentry) | both | `core` · `live` | — |
| `topSeverity` | [The Normalized object — normalized criminal record fields](https://offendersearch.app/docs/criminal/normalized-fields#object-normalized) | both | `felony` · `misdemeanor` · `infraction` · `unknown` | — |
| `verdict` | [The ClearedEntry object — one person a clearance hid from this response](https://offendersearch.app/docs/criminal/clearances#object-clearedentry) | both | `not_this_person` | — |
| `verdict` | [The RecordClearance object — the clearance attached to a kept record](https://offendersearch.app/docs/criminal/clearances#object-recordclearance) | both | `not_this_person` · `this_person` | — |