Case

Each endpoint returns a list of cases, where each case is a JSON dictionary.

Because cases in the Clearinghouse are being added and updated all the time, the case_status of a case is useful for understanding why some fields might be empty. For more information on the different statuses, see case_status.

Example: a completely blank case

{
    attorney_orgs: [],
    case_defendants: [],
    case_documents: [],
    case_dockets: [],
    case_resources: [],
    case_ongoing: "",
    case_status: "",
    case_types: [],
    cause_other: "",
    causes: [],
    class_action_granted: "",
    class_action_sought: "",
    closing_year: null,
    court: "",
    custom_issues: [],
    defendant_payment: "",
    docket_status: "",
    filing_date: "",
    filing_year: null,
    id: 00000,
    injunction_duration: "",
    issues: [],
    last_checked_date: "",
    main_docket: [],
    name: "",
    never_filed: false,
    non_docket_case_number: "",
    non_docket_case_number_type: null,
    non_docket_case_number_type_other: "",
    order_end_year: null,
    order_start_year: null,
    permanent_injunction: false,
    plaintiff_description: "",
    prevailing_party: "",
    pro_se_status: "",
    public_interest_lawyer: "",
    relief_natures: [],
    relief_nature_other: "",
    relief_sources: [],
    settlement_agreement: [],
    settlement_judgment_date: null,
    settlement_judgment_year: null,
    special_collections: [],
    state: "",
    summary: "",
    summary_published_date: "",
    summary_short: "",
    summary_tiny: "",
    terminating_date: null,
    clearinghouse_link: "",
    is_active: true,
    plaintiff_type: [],
    defendant_type: [],
    facility_type: [],
    constitutional_clause: [],
    special_case_type: [],
    content_of_injunction: []
}

For more information:

Field	Type	Documentation (link)
attorney_orgs	array[string]	attorney_orgs
available_documents	array[string]	available_documents
case_defendants	array[object]	case_defendants
case_documents	array[object]	case_documents
case_dockets	array[object]	case_dockets
case_resources	array[object]	case_resources
case_ongoing	string	case_ongoing
case_status	string	case_status
case_types	array[string]	case_types
cause_other	string	cause_other
causes	array[string]	causes
class_action_granted	string	class_action_granted
class_action_sought	string	class_action_sought
closing_year	number	closing_year
court	string	court
custom_issues	array[string]	custom_issues
defendant_payment	string	defendant_payment
docket_status	string	docket_status
filing_date	string	filing_date
filing_year	number	filing_year
id	number	id
injunction_duration	string	injunction_duration
issues	array[string]	issues
last_checked_date	string	last_checked_date
main_docket	array[object]	main_docket
name	string	name
never_filed	boolean	never_filed
non_docket_case_number	string	non_docket_case_number
non_docket_case_number_type	string	non_docket_case_number_type
non_docket_case_number_type_other	string	non_docket_case_number_type_other
order_end_year	number	order_end_year
order_start_year	number	order_start_year
permanent_injunction	boolean	permanent_injunction
plaintiff_description	string	plaintiff_description
prevailing_party	string	prevailing_party
pro_se_status	string	pro_se_status
public_interest_lawyer	string	public_interest_lawyer
relief_natures	array[string]	relief_natures
relief_nature_other	string	relief_nature_other
relief_sources	array[string]	relief_sources
settlement_agreement	array[string]	settlement_agreement
settlement_judgment_date	string	settlement_judgment_date
settlement_judgment_year	number	settlement_judgment_year
special_collections	array[string]	special_collections
state	string	state
summary	string	summary
summary_published_date	string	summary_published_date
summary_short	string	summary_short
summary_tiny	string	summary_tiny
terminating_date	string	terminating_date
clearinghouse_link	string	clearinghouse_link
is_active	boolean	#is_active
plaintiff_type	array[string]	plaintiff_type
defendant_type	array[string]	defendant_type
facility_type	array[string]	facility_type
constitutional_clause	array[string]	constitutional_clause
special_case_type	array[string]	special_case_type
content_of_injunction	array[string]	content_of_injunction