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

{
  "count": 0,
  "next": null,
  "previous": null,
  "results": [
    {
      "attorney_orgs": [],
      "available_documents": [],
      "case_defendants": [],
      "case_ongoing": "",
      "case_status": "",
      "case_types": [],
      "cause_other": "",
      "causes": [],
      "class_action_granted": "",
      "class_action_sought": "",
      "closing_year": null,
      "constitutional_clause": [],
      "content_of_injunction": [
        {
          "value": ""
        },
      ],
      "court": "",
      "custom_issues": [],
      "defendant_payment": "",
      "defendant_type": [
        {
          "value": ""
        }],
      "docket_status": "",
      "facility_type": [],
      "filing_date": "",
      "filing_year": null,
      "id": 0,
      "injunction_duration": "",
      "issues": [],
      "last_checked_date": "",
      "main_docket": {
        "id": 0,
        "docket_entries": [
          {
            "row_number": null,
            "id": 0,
            "entry_number": "",
            "date_filed": "",
            "attachments": [],
            "url": "",
            "recap_pdf_url": null,
            "pacer_doc_id": "",
            "description": ""
          }
        ],
        "docket_case_type": "",
        "docket_year": null,
        "docket_filing_number": null,
        "is_main_docket": true,
        "court": "",
        "state": "",
        "docket_office_number": "",
        "docket_number_manual": "",
        "scales_html": "",
        "recap_link": "",
        "is_active": true
      },
      "name": "",
      "never_filed": false,
      "non_docket_case_number": "",
      "non_docket_case_number_type": "",
      "non_docket_case_number_type_other": "",
      "order_end_year": null,
      "order_start_year": null,
      "permanent_injunction": false,
      "plaintiff_description": "",
      "plaintiff_type": [
        {
          "value": ""
        }],
      "prevailing_party": "",
      "pro_se_status": "",
      "public_interest_lawyer": "",
      "related_cases": [],
      "relief_natures": [],
      "relief_nature_other": "",
      "relief_sources": [],
      "settlement_agreement": [],
      "settlement_judgment_date": "",
      "settlement_judgment_year": null,
      "special_collections": [],
      "special_case_type": [],
      "state": "",
      "summary": "",
      "summary_published_date": "",
      "summary_short": "",
      "summary_tiny": null,
      "terminating_date": null,
      "clearinghouse_link": "",
      "is_active": true,
      "case_documents_url": "",
      "case_dockets_url": "",
      "case_resources_url": ""
    }
  ]
}

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	Case Status
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
case_documents_url	array[string]	https://github.com/CRClearinghouse/CRLCA/blob/master/api-reference-v2/objects/case/pagination-urls.md#case_documents_url
case_dockets_url	array[string]	https://github.com/CRClearinghouse/CRLCA/blob/master/api-reference-v2/objects/case/pagination-urls.md#case_dockets_url
case_resources_url	array[string]	https://github.com/CRClearinghouse/CRLCA/blob/master/api-reference-v2/objects/case/pagination-urls.md#case_resources_url