{"success":true,"data":{"author":"Harvard Library Innovation Lab; Free Law Project (CourtListener)","bucketAccessType":"public","bucketName":"harvard-lil/cold-cases","bucketPrefix":"","category":"Natural Language Processing","cloudProvider":"huggingface","createdAt":"2026-11-21T22:16:38.604Z","description":"Collaborative Open Legal Data (COLD) Cases: 8.3 million published United States court decisions (caselaw) with full opinion text and metadata, one record per decision. The Harvard Library Innovation Lab, working with the Free Law Project, reformats CourtListener's bulk data so that each decision carries its majority, concurring and dissenting opinions with their authors, the head matter, the judges, the filing date (with an approximate-date flag), and the case name in short and full forms. This is the main open corpus for empirical legal studies and judicial politics, for example how judges write and cite precedent, how courts disagree, and how legal language changes over time. It is also used for legal NLP and retrieval. The data is in 32 gzip-compressed Parquet files (about 32 GB); stream it with Hugging Face datasets, or read it with pyarrow or DuckDB. CourtListener states that its bulk data files are free of known copyright restrictions (Public Domain Mark). Credit the Harvard Library Innovation Lab and the Free Law Project (CourtListener).","displayTitle":"COLD Cases: 8.3 Million US Court Decisions with Opinions and Metadata (Harvard Library Innovation Lab, CourtListener)","huggingFaceUrl":"https://huggingface.co/datasets/harvard-lil/cold-cases","id":"fe972a4d-d556-5d91-987d-6cbd32d2aa2f","license":"Public Domain","licenseEvidenceUrl":"https://www.courtlistener.com/help/api/bulk-data/","objectCountEstimate":35,"probeStatus":"ok","region":"us","schemaCard":{"accessHints":[{"language":"python-datasets","snippet":"from datasets import load_dataset\nds = load_dataset(\"harvard-lil/cold-cases\")"},{"language":"python-hub","snippet":"from huggingface_hub import snapshot_download\nsnapshot_download(repo_id=\"harvard-lil/cold-cases\", repo_type=\"dataset\")"}],"caveats":["HuggingFace metadata: author=harvard-lil, license:cc0-1.0, size_categories:100K<n<1M, format:parquet, downloads=6838"],"format":"mixed","generatedAt":"2026-11-21T22:31:55.328Z","layout":{"example":"part-00000-bd7b5d85-e1bd-440b-8817-95ec234884f3-c000.gz.parquet","pattern":"{repoId}/{filename}"},"mountPath":"/mnt/archive","sampleHeaders":[{"bytes":"5041523115001590e20915ccee0615bfa2a7301c15c0b80215001506150800001f8b0800000000000000149c05b854551786dfe9e64ecf4de0726b2e252d5d528220dd5d82a07448aa7497744849837483b402928248289202d25dc2fffd8fcffbac7dceec39b3cfde2bbe85a819d8b3d568d85432cadca9f124e4cc64ebcc14263bd268f59b81feed0df4be6860ebd510a9696efa358be29f69c0e0c8247d8497e4dc9984ab2671192f6f966763f8a804da4e4fe63f5d779c69a4a2c14b4d672c2735dfe0cca4d8053755be49669fbe3bbf5a0e3ec89349c93306ea6fb353a27426339efb98a77bdbca6652feba85951a3fd2dc8bcda3c44ff27241d7538bda287fc7cac1e526c61581f91d6c345e65a0a02b9395e39d4c2997cc98d2510a7e99c191c95e967c90c90f2b8dd49be265e26c17a76f9808e7cd608faefdc5a0769928d936db28343803e3bb184a96b1c1611f0b3e81fd224783ec3c5b9ea1f774e3fcd3409eaa50f9a985f545a3c415c8e4eb4af071c8cd8c7d69cc9ae6e545a2156bb1282ef1b13b07d567a712d43c47f16c9c1ce3c5e4f6d2b75288fc5be228fd3444f5b149949de12529c1c52ff526b0eb071ffdf5ddfadbcdc4fb0c24b833a9dac0c0c6ca364ee97e8b27565ad68d526d77985db2e5e7f8b9d320ca9eca19f4396ca2c1a31083f49dbe3fa7b37f8381ae0533e953d54f95afe017dd2f573c","encoding":"hex","key":"part-00000-bd7b5d85-e1bd-440b-8817-95ec234884f3-c000.gz.parquet","truncatedAt":512}],"sampleObjects":["coldcases-banner.webp","part-00000-bd7b5d85-e1bd-440b-8817-95ec234884f3-c000.gz.parquet","part-00001-bd7b5d85-e1bd-440b-8817-95ec234884f3-c000.gz.parquet","part-00002-bd7b5d85-e1bd-440b-8817-95ec234884f3-c000.gz.parquet","part-00003-bd7b5d85-e1bd-440b-8817-95ec234884f3-c000.gz.parquet"],"sidecars":[{"bytes":"---\nlicense: cc0-1.0\nlanguage:\n- en\ntags:\n- united states\n- law\n- legal\n- court\n- opinions\nsize_categories:\n- 1M<n<10M\nviewer: true\n---\n\n<img src=\"https://huggingface.co/datasets/harvard-lil/cold-cases/resolve/main/coldcases-banner.webp\"/>\n\n# Collaborative Open Legal Data (COLD) - Cases\n\nCOLD Cases is a dataset of 8.3 million United States legal decisions with text and metadata, formatted as compressed parquet files. If you'd like to view a sample of the dataset formatted as JSON Lines, you can view one [here](https://raw.githubusercontent.com/harvard-lil/cold-cases-export/main/sample.jsonl)\n\nThis dataset exists to support the open legal movement exemplified by projects like\n[Pile of Law](https://huggingface.co/datasets/pile-of-law/pile-of-law) and \n[LegalBench](https://hazyresearch.stanford.edu/legalbench/).\nA key input to legal understanding projects is caselaw -- the published, precedential decisions of judges deciding legal disputes and explaining their reasoning.\nUnited States caselaw is collected and published as open data by [CourtListener](https://www.courtlistener.com/), which maintains scrapers to aggregate data from\na wide range of public sources.\n\nCOLD Cases reformats CourtListener's [bulk data](https://www.courtlistener.com/help/api/bulk-data) so that all of the semantic information about each legal decision \n(the authors and text of majority and dissenting opinions; head matter; and substantive metadata) is encoded in a single record per decision, \nwith extraneous data removed. Serving in the traditional role of libraries as a standardization steward, the Harvard Library Innovation Lab is maintaining\nthis [open source](https://github.com/harvard-lil/cold-cases-export) pipeline to consolidate the data engineering for preprocessing caselaw so downstream machine\nlearning and natural language processing projects can use consistent, high quality representations of cases for legal understanding tasks.\n\nPrepared by the [Harvard Library Innovation Lab](https://lil.law.harvard.edu) in collaboration with the [Free Law Project](https://free.law/).\n\n---\n\n## Links\n- [Data nutrition label](https://datanutrition.org/labels/v3/?id=c29976b2-858c-4f4e-b7d0-c8ef12ce7dbe) (DRAFT). ([Archive](https://perma.cc/YV5P-B8JL)).\n- [Pipeline source code](https://github.com/harvard-lil/cold-cases-export)\n\n---\n\n## Summary\n- [Format](#format)\n- [Data dictionary](#data-dictionary)\n- [Notes on appropriate use](#notes-on-appropriate-use)\n\n---\n\n## Format\n\n[Apache Parquet](https://parquet.apache.org/) is binary format that makes filtering and retrieving the data quicker because it lays out the data in columns, which means columns that are unnecessary to satisfy a given query or workflow don't need to be read. Hugging Face's [Datasets](https://huggingface.co/docs/datasets/index) library is an easy way to get started working with the entire dataset, and has features for loading and streaming the data, so you don't need to store it all locally or pay attention to how it's formatted on disk.\n\n[☝️ Go back to Summary](#summary)\n\n---\n\n## Data dictionary\n\nPartial glossary of the fields in the data.\n\n| Field name | Description |\n| --- | --- |\n| `judges` |  Names of judges presiding over the case, extracted from the text. |\n| `date_filed` |  Date the case was filed. Formatted in ISO Date format. |\n| `date_filed_is_approximate` |  Boolean representing whether the `date_filed` value is precise to the day. |\n| `slug` |  Short, human-readable unique string nickname for the case. |\n| `case_name_short` |  Short name for the case. |\n| `case_name` |  Fuller name for the case. |\n| `case_name_full` |  Full, formal name for the case. |\n| `attorneys` |  Names of attorneys arguing the case, extracted from the text. |\n| `nature_of_suit` |  Free text representinng type of suit, such as Civil, Tort, etc. |\n| `syllabus` |  Summary of the questions addressed in the decision, if provided by the reporter of decisions. |\n| `headnotes` |  Textual headnotes of the case |\n| `summary` |  Textual summary of the case |\n| `disposition` |  How the court disposed of the case ","encoding":"utf8","key":"README.md","name":"README.md","size":7834,"truncated":true}],"sourceObjectKey":"part-00000-bd7b5d85-e1bd-440b-8817-95ec234884f3-c000.gz.parquet","starterCell":"from datasets import load_dataset\nds = load_dataset(\"harvard-lil/cold-cases\")\nprint(ds)","starterSamplePath":"part-00000-bd7b5d85-e1bd-440b-8817-95ec234884f3-c000.gz.parquet","totalObjects":35},"summary":"Collaborative Open Legal Data (COLD) Cases: 8.3 million published United States court decisions (caselaw) with full opinion text and metadata, one record per decision.","title":"COLD Cases: 8.3 Million US Court Decisions with Opinions and Metadata (Harvard Library Innovation Lab, CourtListener)","updatedAt":"2026-11-22T00:43:27.382Z","visibility":"public","websiteUrl":"https://github.com/harvard-lil/cold-cases-export"}}