Data codebook

Attorneys

API table: attorneys

Lawyers recorded as representing a party in a case, including appearance and removal dates.

Directory Match is not recorded by the court. Case Harvester compares the name, the city and the years on the case with each listing in the Judiciary's attorney directory, using an AI system, and shows a listing only when one fits clearly. In a labelled check on September 29, 2026, in which two AI reviewers working from written rules labelled sampled pairs independently, 111 of 112 shown matches were correct. The check cannot see a lawyer who is missing from the directory and shares a name with a listed lawyer. Such a lawyer can be matched to that listing. The directory itself is collected by search and is incomplete. Appearances entered under an office or firm name are not matched, and a name that has not yet been compared shows Not compared. See Coverage and known gaps.

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 attorney appearance to case_info.

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

Populated on 100% of served rows (26,432,849 of 26,432,849) and on 100% of records collected since 2026 (10,490,823 of 10,490,823), measured October 15, 2026 at 02:36 UTC

Attorney Name

API field: name

Attorney or government-law-office name listed on the case.

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

Populated on <100% of served rows (26,432,847 of 26,432,849) and on 100% of records collected since 2026 (10,490,823 of 10,490,823), measured October 15, 2026 at 02:36 UTC

Directory Attorney ID

API field: directory_atty_id

The Attorney ID of the directory listing this appearance may refer to. It is blank unless Directory Match is Possible match.

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

Populated on 58.3% of served rows (15,407,086 of 26,432,849) and on 62.2% of records collected since 2026 (6,529,281 of 10,490,823), measured October 15, 2026 at 02:36 UTC

Practice Name Legacy

API field: practice_name

Law practice or firm name recorded for the attorney.

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: contains
  • filter: startsWith
  • filter: endsWith

Populated on 3.3% of served rows (868,240 of 26,432,849) and on 0% of records collected since 2026 (0 of 10,490,823), measured October 15, 2026 at 02:36 UTC

Attorney Type Legacy

API field: attorney_type

Attorney role or type label supplied by the legacy source.

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 (211,149 of 26,432,849) and on 0% of records collected since 2026 (0 of 10,490,823), measured October 15, 2026 at 02:36 UTC

Phone Legacy

API field: phone

Telephone number recorded for the attorney appearance.

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.6% of served rows (1,219,570 of 26,432,849) and on 0% of records collected since 2026 (0 of 10,490,823), measured October 15, 2026 at 02:36 UTC

Appearance Date

API field: appearance_date

Parsed date the attorney's representation began.

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

Populated on 95.7% of served rows (25,302,142 of 26,432,849) and on <100% of records collected since 2026 (10,490,519 of 10,490,823), measured October 15, 2026 at 02:36 UTC

Removal Date

API field: removal_date

Parsed date the attorney's representation ended or was stricken.

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

Populated on 23.9% of served rows (6,313,359 of 26,432,849) and on 16.2% of records collected since 2026 (1,704,696 of 10,490,823), measured October 15, 2026 at 02:36 UTC

Party Row ID

API field: party_id

CaseHarvester identifier of the represented party; null for a source-listed attorney with no recoverable party association.

Served type
Integer
Nullability
May be null
Query capabilities
  • selectable
  • filter: equals
  • filter: set
  • filter: greaterThan
  • filter: greaterThanOrEqual
  • filter: lessThan
  • filter: lessThanOrEqual
  • filter: inRange

Populated on 99.4% of served rows (26,271,023 of 26,432,849) and on 100% of records collected since 2026 (10,490,823 of 10,490,823), measured October 15, 2026 at 02:36 UTC

Attorney Appearance Row ID

API field: id

CaseHarvester's own identifier for this attorney appearance 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 (26,432,849 of 26,432,849) and on 100% of records collected since 2026 (10,490,823 of 10,490,823), measured October 15, 2026 at 02:36 UTC

Legacy Attorney Appearance 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 60.2% of served rows (15,923,727 of 26,432,849) and on 0% of records collected since 2026 (0 of 10,490,823), measured October 15, 2026 at 02:36 UTC

Generated from the current served catalog.