Data codebook

causes

API table: causes

Individual civil claims recorded within a case, including who filed each claim and against whom.

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 that links this cause of action to case_info.

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

Populated on 100% of served rows (6,780,556 of 6,780,556) and on 100% of records collected since 2026 (2,741,666 of 2,741,666), measured October 15, 2026 at 02:45 UTC

Cause Description

API field: cause_description

Claim, issue, or cause of action reported for the civil case.

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

Populated on 98.2% of served rows (6,660,878 of 6,780,556) and on 95.6% of records collected since 2026 (2,621,988 of 2,741,666), measured October 15, 2026 at 02:45 UTC

Filed By

API field: filed_by

Source role or party side that filed the cause of action.

Served type
String
Nullability
May be null
Query capabilities
  • selectable

Populated on 71.5% of served rows (4,850,753 of 6,780,556) and on 76.2% of records collected since 2026 (2,088,434 of 2,741,666), measured October 15, 2026 at 02:45 UTC

Filed Against

API field: filed_against

Source role or party side against which the cause of action was filed.

Served type
String
Nullability
May be null
Query capabilities
  • selectable

Populated on 71.5% of served rows (4,844,769 of 6,780,556) and on 76% of records collected since 2026 (2,082,450 of 2,741,666), measured October 15, 2026 at 02:45 UTC

Filed Date

API field: file_date

Parsed date the cause of action was filed.

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 81.2% of served rows (5,503,985 of 6,780,556) and on 100% of records collected since 2026 (2,741,666 of 2,741,666), measured October 15, 2026 at 02:45 UTC

Cause Row ID

API field: id

CaseHarvester's own identifier for this cause row.

Served type
Integer
Nullability
Always present on a served row
Query capabilities
  • selectable
  • filter: equals
  • filter: set
  • filter: greaterThan
  • filter: greaterThanOrEqual
  • filter: lessThan
  • filter: lessThanOrEqual
  • filter: inRange

Populated on 100% of served rows (6,780,556 of 6,780,556) and on 100% of records collected since 2026 (2,741,666 of 2,741,666), measured October 15, 2026 at 02:45 UTC

Legacy Cause Row ID Legacy

API field: legacy_id

Row identifier this record carried in the legacy table it was migrated from.

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 40.7% of served rows (2,762,319 of 6,780,556) and on 0% of records collected since 2026 (0 of 2,741,666), measured October 15, 2026 at 02:45 UTC

Generated from the current served catalog.