# 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](https://api.clearinghouse.net/api-reference-v2/objects/case-status#case_status "mention").
Example: a completely blank case ```javascript { "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](https://api.clearinghouse.net/api-reference-v2/objects/parties#attorney_orgs "mention") | | available\_documents | array\[string] | [#available\_documents](https://api.clearinghouse.net/api-reference-v2/objects/documents#available_documents "mention") | | case\_defendants | array\[object] | [#case\_defendants](https://api.clearinghouse.net/api-reference-v2/objects/parties#case_defendants "mention") | | case\_documents | array\[object] | [#case\_documents](https://api.clearinghouse.net/api-reference-v2/objects/documents#case_documents "mention") | | case\_dockets | array\[object] | [#case\_dockets](https://api.clearinghouse.net/api-reference-v2/objects/dockets#case_dockets "mention") | | case\_resources | array\[object] | [#case\_resources](https://api.clearinghouse.net/api-reference-v2/objects/resources#case_resources "mention") | | case\_ongoing | string | [#case\_ongoing](https://api.clearinghouse.net/api-reference-v2/objects/case-details#case_ongoing "mention") | | case\_status | string | [#case\_status](https://api.clearinghouse.net/api-reference-v2/objects/case-status#case_status "mention") | | case\_types | array\[string] | [#case\_types](https://api.clearinghouse.net/api-reference-v2/objects/case-details#case_types "mention") | | cause\_other | string | [#cause\_other](https://api.clearinghouse.net/api-reference-v2/objects/causes-of-action#cause_other "mention") | | causes | array\[string] | [#causes](https://api.clearinghouse.net/api-reference-v2/objects/causes-of-action#causes "mention") | | class\_action\_granted | string | [#class\_action\_granted](https://api.clearinghouse.net/api-reference-v2/objects/parties#class_action_granted "mention") | | class\_action\_sought | string | [#class\_action\_sought](https://api.clearinghouse.net/api-reference-v2/objects/parties#class_action_sought "mention") | | closing\_year | number | [#closing\_year](https://api.clearinghouse.net/api-reference-v2/objects/key-dates#closing_year "mention") | | court | string | [#court](https://api.clearinghouse.net/api-reference-v2/objects/case-details#court "mention") | | custom\_issues | array\[string] | [#custom\_issues](https://api.clearinghouse.net/api-reference-v2/objects/issues#custom_issues "mention") | | defendant\_payment | string | [#defendant\_payment](https://api.clearinghouse.net/api-reference-v2/objects/outcome#defendant_payment "mention") | | docket\_status | string | [#docket\_status](https://api.clearinghouse.net/api-reference-v2/objects/case-status#docket_status "mention") | | filing\_date | string | [#filing\_date](https://api.clearinghouse.net/api-reference-v2/objects/key-dates#filing_date "mention") | | filing\_year | number | [#filing\_year](https://api.clearinghouse.net/api-reference-v2/objects/key-dates#filing_year "mention") | | id | number | [#id](https://api.clearinghouse.net/api-reference-v2/objects/case-details#id "mention") | | injunction\_duration | string | [#injunction\_duration](https://api.clearinghouse.net/api-reference-v2/objects/key-dates#injunction_duration "mention") | | issues | array\[string] | [#issues](https://api.clearinghouse.net/api-reference-v2/objects/issues#issues "mention") | | last\_checked\_date | string | [#last\_checked\_date](https://api.clearinghouse.net/api-reference-v2/objects/case-status#last_checked_date "mention") | | main\_docket | array\[object] | [#main\_docket](https://api.clearinghouse.net/api-reference-v2/objects/dockets#main_docket "mention") | | name | string | [#name](https://api.clearinghouse.net/api-reference-v2/objects/case-details#name "mention") | | never\_filed | boolean | [#never\_filed](https://api.clearinghouse.net/api-reference-v2/objects/key-dates#never_filed "mention") | | non\_docket\_case\_number | string | [#non\_docket\_case\_number](https://api.clearinghouse.net/api-reference-v2/objects/dockets#non_docket_case_number "mention") | | non\_docket\_case\_number\_type | string | [#non\_docket\_case\_number\_type](https://api.clearinghouse.net/api-reference-v2/objects/dockets#non_docket_case_number_type "mention") | | non\_docket\_case\_number\_type\_other | string | [#non\_docket\_case\_number\_type\_other](https://api.clearinghouse.net/api-reference-v2/objects/dockets#non_docket_case_number_type_other "mention") | | order\_end\_year | number | [#order\_end\_year](https://api.clearinghouse.net/api-reference-v2/objects/key-dates#order_end_year "mention") | | order\_start\_year | number | [#order\_start\_year](https://api.clearinghouse.net/api-reference-v2/objects/key-dates#order_start_year "mention") | | permanent\_injunction | boolean | [#permanent\_injunction](https://api.clearinghouse.net/api-reference-v2/objects/key-dates#permanent_injunction "mention") | | plaintiff\_description | string | [#plaintiff\_description](https://api.clearinghouse.net/api-reference-v2/objects/parties#plaintiff_description "mention") | | prevailing\_party | string | [#prevailing\_party](https://api.clearinghouse.net/api-reference-v2/objects/outcome#prevailing_party "mention") | | pro\_se\_status | string | [#pro\_se\_status](https://api.clearinghouse.net/api-reference-v2/objects/parties#pro_se_status "mention") | | public\_interest\_lawyer | string | [#public\_interest\_lawyer](https://api.clearinghouse.net/api-reference-v2/objects/parties#public_interest_lawyer "mention") | | relief\_natures | array\[string] | [#relief\_natures](https://api.clearinghouse.net/api-reference-v2/objects/outcome#relief_natures "mention") | | relief\_nature\_other | string | [#relief\_nature\_other](https://api.clearinghouse.net/api-reference-v2/objects/outcome#relief_nature_other "mention") | | relief\_sources | array\[string] | [#relief\_sources](https://api.clearinghouse.net/api-reference-v2/objects/outcome#relief_sources "mention") | | settlement\_agreement | array\[string] | [#settlement\_agreement](https://api.clearinghouse.net/api-reference-v2/objects/outcome#settlement_agreement "mention") | | settlement\_judgment\_date | string | [#settlement\_judgment\_date](https://api.clearinghouse.net/api-reference-v2/objects/key-dates#settlement_judgment_date "mention") | | settlement\_judgment\_year | number | [#settlement\_judgment\_year](https://api.clearinghouse.net/api-reference-v2/objects/key-dates#settlement_judgment_year "mention") | | special\_collections | array\[string] | [#special\_collections](https://api.clearinghouse.net/api-reference-v2/objects/case-details#special_collections "mention") | | state | string | [#state](https://api.clearinghouse.net/api-reference-v2/objects/case-details#state "mention") | | summary | string | [#summary](https://api.clearinghouse.net/api-reference-v2/objects/summaries#summary "mention") | | summary\_published\_date | string | [#summary\_published\_date](https://api.clearinghouse.net/api-reference-v2/objects/summaries#summary_published_date "mention") | | summary\_short | string | [#summary\_short](https://api.clearinghouse.net/api-reference-v2/objects/summaries#summary_short "mention") | | summary\_tiny | string | [#summary\_tiny](https://api.clearinghouse.net/api-reference-v2/objects/summaries#summary_tiny "mention") | | terminating\_date | string | [#terminating\_date](https://api.clearinghouse.net/api-reference-v2/objects/key-dates#terminating_date "mention") | | clearinghouse\_link | string | [#clearinghouse\_link](https://api.clearinghouse.net/api-reference-v2/objects/case-details#clearinghouse_link "mention") | | is\_active | boolean | [#is\_active](https://api.clearinghouse.net/api-reference-v2/objects/case-status#is_active "mention") | | plaintiff\_type | array\[string] | [#plaintiff\_type](https://api.clearinghouse.net/api-reference-v2/objects/issues#plaintiff_type "mention") | | defendant\_type | array\[string] | [#defendant\_type](https://api.clearinghouse.net/api-reference-v2/objects/issues#defendant_type "mention") | | facility\_type | array\[string] | [#facility\_type](https://api.clearinghouse.net/api-reference-v2/objects/issues#facility_type "mention") | | constitutional\_clause | array\[string] | [#constitutional\_clause](https://api.clearinghouse.net/api-reference-v2/objects/issues#constitutional_clause "mention") | | special\_case\_type | array\[string] | [#special\_case\_type](https://api.clearinghouse.net/api-reference-v2/objects/issues#special_case_type "mention") | | content\_of\_injunction | array\[string] | [#content\_of\_injunction](https://api.clearinghouse.net/api-reference-v2/objects/issues#content_of_injunction "mention") | | case\_documents\_url | array\[string] | [https://github.com/CRClearinghouse/CRLCA/blob/master/api-reference-v2/objects/case/pagination-urls.md#case\_documents\_url](https://github.com/CRClearinghouse/CRLCA/blob/master/api-reference-v2/objects/case/pagination-urls.md#case_documents_url "mention") | | case\_dockets\_url | array\[string] | [https://github.com/CRClearinghouse/CRLCA/blob/master/api-reference-v2/objects/case/pagination-urls.md#case\_dockets\_url](https://github.com/CRClearinghouse/CRLCA/blob/master/api-reference-v2/objects/case/pagination-urls.md#case_dockets_url "mention") | | case\_resources\_url | array\[string] | [https://github.com/CRClearinghouse/CRLCA/blob/master/api-reference-v2/objects/case/pagination-urls.md#case\_resources\_url](https://github.com/CRClearinghouse/CRLCA/blob/master/api-reference-v2/objects/case/pagination-urls.md#case_resources_url "mention") |