Skip to main content
  • ABOUT
  • CASELAW
  • GALLERY
  • LOG IN
  • FOR COURTS
  • CONTACT
Documentation / User Pathways / Getting Researcher Access
    • For Researchers
        • How do you want to access caselaw data?
          • Bulk Downloads
          • API
        • What level of access do you need?
        • How do I register?
        • How do I apply for researcher access?
          • Important Caveats
          • Eligibility
          • Where do I apply?
            • Harvard
            • Other Institutions
            • Others
    • For Courts
        • Digital-First Guidelines
            • Introduction
            • Digital-first publishing guidelines
              • Essential characteristics
                • Online
                • Free & Open
                • Comprehensive
                • Official
                • Citable
                • Machine Readable
              • Desirable characteristics
                • Digitally Signed
                • Versioning
                • Structured Data
                • Medium-Neutral
                • Archives
                • Search
                • Bulk
                • API
        • Case Studies
            • Case study: Arkansas
            • Case study: Canada
            • Case study: New Mexico
    • For Libraries
    • Registration
    • Search
        • Overview
        • What's included?
        • Searching in CAP is simple
          • First: Choose What To Search
          • Second: Select Your Search Criteria
          • Third: Execute the Search
        • Full-Text Case Search
          • Phrase Search
          • Exclusion
        • Tips
        • Getting Legal Help
    • API
        • API Learning Track
        • Authentication
          • Get an API Key
          • Modify The Request Headers
          • Example
          • Failure: error_auth_required
          • Browsable API
          • Sitewide Token Authentication
        • Case Text Formats
        • Pagination and Counts
          • Example
        • Endpoints
          • API Base
          • Cases Endpoint
            • Endpoint Parameters
            • Single Case Endpoint
            • Search Syntax
            • Examples
          • Reporters Endpoint
            • Endpoint Parameters
            • Examples
          • Jurisdictions Endpoint
            • Endpoint Parameters
          • Courts
            • Endpoint Parameters
          • Volumes
            • Endpoint Parameters
          • Ngrams
            • Endpoint Parameters
            • Examples
          • Citations
            • Endpoint Parameters
    • Bulk Data
        • Access Limits
        • Downloading
        • API Equivalence
        • Data Format
        • Using Bulk Data
        • Other repositories
    • Historical Trends
        • Start Here
        • Reading Results
          • Key
          • Horizontal axis
          • Vertical axis
        • Customize
          • Percentage Count/Instance Count/Scaling
          • Smoothing
        • Table view
        • Keyboard navigation
        • Download
        • Wildcard search
        • Jurisdiction search
        • Jurisdiction codes
        • Citation feature
    • API Learning Track
        • Intro to APIs
        • CAP API Tutorial
            • Intro: Browsable API
            • Intro to JSON
            • curl
            • Overview of the endpoints
            • Dig-in With Real Queries
            • Next Steps
            • Wrap-up
        • CAP API In Depth
            • Getting Started
              • Making Basic Queries
              • Filtering
              • Search
                • Full-text Search
                • Filtering by Groups or Ranges
              • Sorting
              • Types of Data You Can Query
            • Getting Full Case Text
            • Authentication
              • Find your API Key
              • Modify Your Headers
                • curl
                • python requests library
                • Other Environments
              • Doesn't work?
                • error_auth_required
                • error_limit_exceeded
            • Data Formats
              • Structured Casebody Text
            • Other Endpoints
    • Access Limits
        • Exceptions
        • Open Jurisditions
        • Research Access
        • Commercial Licensing
        • User Types and Permissions
          • Unregistered Users
          • Registered Users
          • Researchers
          • Commercial Users
    • Stability and Changes
    • Reporting Problems
        • Misspelled Words
        • Website Errors
        • Metadata Errors
    • Documentation Glossary
        • API
        • Character
        • Special Character
        • Command Line
        • curl
        • Endpoint
        • Jurisdiction
        • OCR
        • RESTful
        • Reporter
        • Server
        • Slug
        • String
        • Top-Level Domain
        • URL
        • URL Parameter
        • URL Path
        • Open Jurisdiction
        • Restricted Jurisdiction
        • Cursor
    • Data Specifications
        • Bulk
          • Structure
          • Data Format
        • API
          • Individual Records
          • Query Results
        • Individual Objects
          • Case
            • Casebody
            • Analysis Fields
          • Jurisdiction
          • Court
          • Volume
          • Reporter
          • Citation
          • Ngrams
    • Changelog
        • August 28 2020
        • August 2020
        • June 2020
        • April 2020
        • March 2020
        • February 2020
        • January 24, 2020
        • January 19, 2020
        • January 16, 2020
        • January 9, 2020
        • December 6, 2019
        • October 1, 2019
        • July 31, 2019
        • June 19, 2019

This document will guide you through getting access to CAP data. We will:

  • Briefly explain our primary data access tools and what each is useful for.
  • Show you where to get more information about registering, using the tools and data, and using our site.
  • Help you determine what level of access you need to access the data you're interested in for your research.

How do you want to access caselaw data?

We offer a number of tools to access caselaw, which you can browse at our tools page.

If you are interested in offline computational analysis, you might be particularly interested in the API and Bulk Downloads. Which one is right for you depends on your use case. The data allowances are exactly the same using both methods.

Bulk Downloads

Bulk downloads are large, zipped files with conveniently formatted data for stream processing. They are useful for tasks like natural language processing where you want to download large numbers of cases by court or jurisdiction and filter them locally.

  • Bulk Downloads User Guide
  • Bulk Download Page

API

Our RESTful API is useful for users who need to work interactively with our data without downloading all of it or need more customized/filtered data rather than one monolithic download.

  • API Reference
  • Interactive API Browser
  • API Learning Track

What level of access do you need?

Whether you're using the API or bulk downloading, there are some data access considerations to keep in mind. Some of our data is entirely unrestricted and doesn't even require a login or API token. Some is limited to a certain number of cases per day for most users. Academic researcher accounts are entirely unrestricted, but must sign an agreement limiting their ability to redistribute the data.

Many types of data are available without logging in and without restriction.

  • Metadata
  • n-gram statistics
  • Citation graphs
  • Case text from open jurisdictions:
    • Illinois
    • Arkansas
    • North Carolina
    • New Mexico

If your use case is satisfied by these, you don't even need to create an account. Just start querying the API or downloading available bulk data, and you're good to go.

If you need API access to case text from restricted jurisdictions, you'll at least need to create an account to authenticate your API requests. If you need 500 or fewer case texts per day, that's all you need.

If you must access more than 500 case texts per day from restricted jurisdictions, you will need an unthrottled researcher account.

Headnotes and other publisher-created work added to cases after 1924 are not available through this project.

How do I register?

Check out our quick Registration Guide. If you need it, you can find your API key by clicking on the ACCOUNT link at the top of the page.

How do I apply for researcher access?

If you are a research scholar and your work requires access to the full text of more than 500 cases per day, you may apply for unmetered access via your account page.

Important Caveats

You must enter into a special bulk access agreement with LexisNexis, which prohibits you from:

  • using the cases for non-research or commercial purposes and
  • sharing bulk caselaw with others.

Eligibility

To be eligible, you must demonstrate that you are a research scholar.

Where do I apply?

Once you have an account:

Harvard community members

If you are a member of the Harvard community with a Harvard email address, you can sign the Harvard bulk access agreement and you will immediately have full access from Harvard IP addresses.

Other Educational or non-profit affiliates

If you are officially affiliated with an educational or non-profit research institution, sign this application to request access and your application will be reviewed shortly.

Other researchers

If you do not otherwise qualify for unmetered access, fill out this form to explain your standing as an independent research scholar and we will do our best to work with you or refer you to an appropriate organization.

Please contact us with any questions.

  • Find what you were looking for?

    If you have suggestions for improving this documentation, let us know!

Getting Researcher Access

Want to get started with data from the Caselaw Access Project but aren't sure where to start? This guide will point you in the right direction for your use case.

©2021 The President and Fellows of Harvard University. Site text is licensed CC BY-SA 4.0. Source code is MIT licensed. Harvard asserts no copyright in caselaw retrieved from this site.

  • TERMS
  • PRIVACY
  • ACCESSIBILITY