Data codebook

Cases

API table: case_info

Maryland court cases, with one row per case.

Definitions have been recorded for some columns and not others. A column with no definition below has not been documented yet.

A field with a fixed, closed set of values lists that set below. A field with documented codes lists its known values, and shows a meaning for the ones that have been described. Other value lists are not published here. Licensed clients can read them through GET /metadata.

Case Number

API field: case_number

Maryland Judiciary case number and primary key for the unified case record.

Served type
String
Nullability
Always present on a served row
Query capabilities
  • selectable
  • filter: equals
  • filter: set
  • filter: startsWith
  • filter: contains

Populated on 100% of served rows (35,850,213 of 35,850,213) and on 100% of records collected since 2026 (12,143,232 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Case Title

API field: case_title

Case caption or title supplied by Case Search; policy-protected rows may return null.

Served type
String
Nullability
May be null
Redaction
Returned as null when the row belongs to a protected person.
Query capabilities
  • selectable

Populated on 31.7% of served rows (11,371,638 of 35,850,213) and on 42.9% of records collected since 2026 (5,208,721 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Case Type

API field: case_type

Case Search case-type label; the vocabulary varies by court system and source era.

Served type
String
Nullability
May be null
Query capabilities
  • selectable
  • filter: equals
  • filter: set
  • aggregate group

Populated on 91.6% of served rows (32,824,015 of 35,850,213) and on 100% of records collected since 2026 (12,143,232 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Case Status

API field: case_status

Current status text or code supplied by Case Search.

Served type
String
Nullability
May be null
Query capabilities
  • selectable
  • filter: equals
  • filter: set
  • aggregate group

Populated on <100% of served rows (35,848,231 of 35,850,213) and on 100% of records collected since 2026 (12,143,232 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Court System

API field: court_system

Case Search's own label for the court, such as District Court For Howard County - Probate. It names the court level, the county, and the kind of case in one value. To filter on those separately, use County, Court Level, and Case Category.

Served type
String
Nullability
May be null
Query capabilities
  • selectable
  • filter: equals
  • filter: set
  • aggregate group

Populated on <100% of served rows (35,850,197 of 35,850,213) and on <100% of records collected since 2026 (12,143,216 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Court Level

API field: court_level

Derived Maryland court level from the Case Search court system label: circuit, district, or appellate. Null means the level could not be established.

Served type
String
Nullability
May be null
Query capabilities
  • selectable
  • filter: equals
  • filter: set
  • aggregate group

Populated on <100% of served rows (35,849,736 of 35,850,213) and on <100% of records collected since 2026 (12,143,216 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Court Name

API field: court_name

The courthouse hearing the case, as Case Search names it. District Court locations appear by place, such as Towson or Glen Burnie. To find cases by county, use County.

Served type
String
Nullability
May be null
Query capabilities
  • selectable
  • filter: equals
  • filter: set
  • filter: blank
  • filter: contains
  • filter: startsWith
  • filter: endsWith

Populated on 71.9% of served rows (25,788,898 of 35,850,213) and on 99.8% of records collected since 2026 (12,115,270 of 12,143,232), measured October 15, 2026 at 02:45 UTC

County

API field: court_county

The county whose court holds the case. Use it to find cases by county, including landlord-tenant cases. Baltimore City counts as a county. Blank for appellate courts, which have none, and where Case Harvester could not determine the county.

Served type
String
Nullability
May be null
Query capabilities
  • selectable
  • filter: equals
  • filter: set
  • aggregate group

Populated on 99.9% of served rows (35,821,365 of 35,850,213) and on 99.8% of records collected since 2026 (12,116,506 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Filed Date

API field: filed_date

Parsed date the case was filed, as supplied by Case Search.

Served type
Date
Nullability
May be null
Query capabilities
  • selectable
  • sortable
  • default sort: desc
  • filter: equals
  • filter: set
  • filter: greaterThan
  • filter: greaterThanOrEqual
  • filter: lessThan
  • filter: lessThanOrEqual
  • filter: inRange
  • date bucket

Populated on 85.2% of served rows (30,543,064 of 35,850,213) and on 100% of records collected since 2026 (12,143,232 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Case Category

API field: case_category

Unified category: CV civil, CR criminal, FAM family, AP appellate, PR probate, or DV domestic violence. Null means the case is on a general civil or appellate docket that hears more than one of these, so no category was recorded rather than guessed.

Served type
String
Nullability
May be null
Query capabilities
  • selectable
  • filter: equals
  • filter: set
  • aggregate group

Populated on 74.3% of served rows (26,633,077 of 35,850,213) and on 100% of records collected since 2026 (12,143,232 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Known values

The data can carry values this list does not name.

  • CV (Civil)
  • CR (Criminal)
  • FAM (Family)
  • AP (Appellate)
  • PR (Probate)
  • DV (Domestic violence)
  • (empty value)

Case Disposition Legacy

API field: case_disposition

Case-level result supplied by Case Search; charge-level results are in charges.

Served type
String
Nullability
May be null
Legacy
Only records collected before 2026 have a value in this field. Records collected since leave it blank.
Query capabilities
  • selectable
  • filter: equals
  • filter: set
  • aggregate group

Populated on 8.7% of served rows (3,119,179 of 35,850,213) and on 0% of records collected since 2026 (0 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Violation County

API field: violation_county

Where the offense happened, as Case Search lists it. Criminal and traffic cases carry it about six times in ten. Civil and landlord-tenant cases never do. To find cases by county, use County.

Served type
String
Nullability
May be null
Query capabilities
  • selectable
  • filter: equals
  • filter: set
  • aggregate group

Populated on 32.9% of served rows (11,787,170 of 35,850,213) and on 32.3% of records collected since 2026 (3,919,084 of 12,143,232), measured October 15, 2026 at 02:45 UTC

District Code Legacy

API field: district_code

Legacy Case Search district identifier; present only for source formats that supplied it.

Served type
Integer
Nullability
May be null
Legacy
Only records collected before 2026 have a value in this field. Records collected since leave it blank.
Query capabilities
  • selectable

Populated on 19.5% of served rows (7,003,295 of 35,850,213) and on 0% of records collected since 2026 (0 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Location Code Legacy

API field: location_code

Legacy Case Search court-location identifier; present only for source formats that supplied it.

Served type
Integer
Nullability
May be null
Legacy
Only records collected before 2026 have a value in this field. Records collected since leave it blank.
Query capabilities
  • selectable

Populated on 19.5% of served rows (7,003,295 of 35,850,213) and on 0% of records collected since 2026 (0 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Charging Document Issued Date Legacy

API field: issued_date

Parsed date the charging document was issued for legacy criminal cases.

Served type
Date
Nullability
May be null
Legacy
Only records collected before 2026 have a value in this field. Records collected since leave it blank.
Query capabilities
  • selectable

Populated on 7.6% of served rows (2,717,631 of 35,850,213) and on 0% of records collected since 2026 (0 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Incident Date Legacy

API field: incident_date

Parsed offense or incident date from legacy criminal case formats.

Served type
Date
Nullability
May be null
Legacy
Only records collected before 2026 have a value in this field. Records collected since leave it blank.
Query capabilities
  • selectable

Populated on <1% of served rows (282,403 of 35,850,213) and on 0% of records collected since 2026 (0 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Violation Date

API field: violation_date

Parsed violation date for citation or traffic cases.

Served type
Date
Nullability
May be null
Query capabilities
  • selectable

Populated on 32.9% of served rows (11,797,955 of 35,850,213) and on 32.4% of records collected since 2026 (3,930,808 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Violation Time

API field: violation_time

Violation time as supplied by Case Search.

Served type
String
Nullability
May be null
Query capabilities
  • selectable

Populated on 20.2% of served rows (7,256,254 of 35,850,213) and on 15.9% of records collected since 2026 (1,929,004 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Disposition Date Legacy

API field: disposition_date

Parsed case-level disposition date.

Served type
Date
Nullability
May be null
Legacy
Only records collected before 2026 have a value in this field. Records collected since leave it blank.
Query capabilities
  • selectable

Populated on 2.2% of served rows (784,273 of 35,850,213) and on 0% of records collected since 2026 (0 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Case Status Date

API field: case_status_date

Parsed date on which the reported case status took effect.

Served type
Date
Nullability
May be null
Query capabilities
  • selectable

Populated on 35.1% of served rows (12,582,279 of 35,850,213) and on <100% of records collected since 2026 (12,141,995 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Order Valid Through

API field: order_valid_through

Parsed expiration date of the domestic-violence order.

Served type
Date
Nullability
May be null
Query capabilities
  • selectable

Populated on 1.2% of served rows (417,961 of 35,850,213) and on <1% of records collected since 2026 (1,237 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Case Status Comment

API field: case_status_comment

Free-text comment accompanying the Case Search case status.

Served type
String
Nullability
May be null
Query capabilities
  • selectable

Populated on 11.1% of served rows (3,971,467 of 35,850,213) and on 32.7% of records collected since 2026 (3,971,467 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Assigned Judge

API field: judge_assigned

Judge assigned to the case, as supplied by Case Search.

Served type
String
Nullability
May be null
Query capabilities
  • selectable

Populated on 3.4% of served rows (1,207,027 of 35,850,213) and on 8.5% of records collected since 2026 (1,026,195 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Judicial Officer Legacy

API field: judicial_officer

Judicial officer named by the source for the case.

Served type
String
Nullability
May be null
Legacy
Only records collected before 2026 have a value in this field. Records collected since leave it blank.
Query capabilities
  • selectable

Populated on <1% of served rows (9,799 of 35,850,213) and on 0% of records collected since 2026 (0 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Authoring Judge Legacy

API field: authoring_judge

Judge credited as the author of a legacy appellate opinion.

Served type
String
Nullability
May be null
Legacy
Only records collected before 2026 have a value in this field. Records collected since leave it blank.
Query capabilities
  • selectable

Populated on <1% of served rows (143 of 35,850,213) and on 0% of records collected since 2026 (0 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Magistrate

API field: magistrate

Magistrate named by Case Search for the case.

Served type
String
Nullability
May be null
Query capabilities
  • selectable

Populated on <1% of served rows (27,616 of 35,850,213) and on <1% of records collected since 2026 (25,029 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Agency Name Legacy

API field: agency_name

Law-enforcement or filing agency recorded at the case level.

Served type
String
Nullability
May be null
Legacy
Only records collected before 2026 have a value in this field. Records collected since leave it blank.
Query capabilities
  • selectable

Populated on 7.2% of served rows (2,581,428 of 35,850,213) and on 0% of records collected since 2026 (0 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Officer Name Legacy

API field: officer_name

Officer name recorded at the case level.

Served type
String
Nullability
May be null
Legacy
Only records collected before 2026 have a value in this field. Records collected since leave it blank.
Query capabilities
  • selectable

Populated on 4.2% of served rows (1,521,411 of 35,850,213) and on 0% of records collected since 2026 (0 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Officer ID Legacy

API field: officer_id

Source-system identifier for the officer recorded at the case level.

Served type
String
Nullability
May be null
Legacy
Only records collected before 2026 have a value in this field. Records collected since leave it blank.
Query capabilities
  • selectable

Populated on 7.2% of served rows (2,583,502 of 35,850,213) and on 0% of records collected since 2026 (0 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Charge Tracking Number

API field: charge_track_number

Charging-document tracking number supplied by Case Search.

Served type
String
Nullability
May be null
Query capabilities
  • selectable

Populated on 18.4% of served rows (6,597,556 of 35,850,213) and on 6.6% of records collected since 2026 (804,339 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Charging Document Type Legacy

API field: document_type

Type of charging document for legacy criminal cases, such as citation, information, summons, statement of charges, or warrant.

Served type
String
Nullability
May be null
Legacy
Only records collected before 2026 have a value in this field. Records collected since leave it blank.
Query capabilities
  • selectable
  • filter: equals
  • filter: set
  • aggregate group

Populated on 7.6% of served rows (2,717,628 of 35,850,213) and on 0% of records collected since 2026 (0 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Shielded

API field: possibly_shielded

Yes when Case Harvester collected this case and Case Search later stopped showing it. No means Case Search still showed the case the last time Case Harvester read it. Blank means it has not been checked yet. This records what Case Harvester observed, not a court finding.

Served type
Boolean
Nullability
May be null
Query capabilities
  • selectable
  • filter: equals
  • filter: set
  • aggregate group

Populated on 100% of served rows (35,850,213 of 35,850,213) and on 100% of records collected since 2026 (12,143,232 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Has Removed Charges

API field: has_expunged_charges

Yes when at least one of this case's charges is marked Removed from Case Search. Removal may reflect an expungement order or a law that bars Case Search from showing the charge. No means none of its charges is marked. Blank means it has not been checked yet.

Served type
Boolean
Nullability
May be null
Query capabilities
  • selectable
  • filter: equals
  • filter: set
  • aggregate group

Populated on 100% of served rows (35,850,213 of 35,850,213) and on 100% of records collected since 2026 (12,143,232 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Has Protected Party

API field: has_protected_party

Derived true when party-protection policy requires withholding data for at least one party. Historical rows default to true until the protection backfill proves they can be released.

Served type
Boolean
Nullability
Always present on a served row
Query capabilities
  • selectable

Populated on 100% of served rows (35,850,213 of 35,850,213) and on 100% of records collected since 2026 (12,143,232 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Source Envelope

API field: envelope

Case Search JSON record type that supplied the record: caseDetail or dvCaseDTO.

Served type
String
Nullability
May be null
Query capabilities
  • selectable

Populated on 33.9% of served rows (12,143,232 of 35,850,213) and on 100% of records collected since 2026 (12,143,232 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Internal Case ID

API field: internal_id

Case Search internal numeric identifier for the case, when the source supplies one.

Served type
Integer
Nullability
May be null
Query capabilities
  • selectable

Populated on 33.9% of served rows (12,141,995 of 35,850,213) and on <100% of records collected since 2026 (12,141,995 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Domestic Violence Case Index

API field: case_idx

Case Search case index supplied by the domestic-violence dvCaseDTO envelope.

Served type
String
Nullability
May be null
Query capabilities
  • selectable

Populated on <1% of served rows (1,237 of 35,850,213) and on <1% of records collected since 2026 (1,237 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Court Node ID

API field: court_node_id

Case Search internal numeric identifier for the court.

Served type
Integer
Nullability
May be null
Query capabilities
  • selectable

Populated on 33.8% of served rows (12,115,270 of 35,850,213) and on 99.8% of records collected since 2026 (12,115,270 of 12,143,232), measured October 15, 2026 at 02:45 UTC

Generated from the current served catalog.