Skip to main content
  • ABOUT
  • CASELAW
  • GALLERY
  • LOG IN
  • FOR COURTS
  • CONTACT
Documentation / User Pathways / For Courts / Digital-First Guidelines
    • 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

Introduction

Ensuring public access to law is a fundamental obligation of our government. For centuries our courts have fulfilled this obligation by publishing and disseminating their written decisions in books. Today, books are no longer adequate to this task. In a modern world, ensuring public access to court decisions means publishing and distributing them online for free, without usage restrictions.

Below are guidelines for any state making the transition to digital-first publishing. Because each state court system has different challenges, constraints and opportunities, we expect to see different approaches emerge. The guidelines below recognize this need for flexibility. They outline a common, achievable standard, but they do not dictate particular means or methods.

For states administering their own digital-first publishing systems, these guidelines can inform that system’s priorities and design. For states that will rely on the software and/or services of a commercial vendor, these guidelines can help define an RFP and inform negotiations and contracting.

Digital-first publishing guidelines

Essential characteristics

Online

Court decisions should be issued and available online.

Free & Open

Court decisions should be accessible without charge and without restrictions on access or usage.

Comprehensive

All decisions should be made available digitally in the same fashion, using the same system. If a state distinguishes between precedential and non-precedential decisions, that distinction should not affect access.

Official

The digital versions of decisions should be the official versions.

Citable

The digital version should be citable in and by the courts of the relevant state, using vendor-neutral citation formats.

Machine Readable

The decisions should be made available in machine-readable formats, meaning at least digitally created PDFs.

Desirable characteristics

Digitally Signed

Decisions should be digitally signed by the issuing court to permit authentication.

Versioning

Decisions should be issued using a version control system that makes corrections easy for the courts and transparent to those relying on the decisions.

Structured Data

Decisions should be issued with accompanying metadata that describes, according to a publicly disclosed standard, key attributes of the decisions, such as case name, citation, court name, attorneys, participating judges and authoring judge.

Medium-Neutral

Decisions should include paragraph numbering and avoid page dependency.

Archives

Decisions should be preserved, and the archives should be made available online.

Search

Decisions should be searchable using keywords and metadata fields.

Bulk

Decisions should be downloadable in bulk.

API

Decisions should be accessible to any programmer via a public, documented API (Application Programming Interface).

For questions and discussion, please contact us!

  • Find what you were looking for?

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

Digital-First Guidelines

The CAP Digital-First Guidelines describe essential and desirable characteristics for digital-first caselaw publishing systems, whether you are drafting an RFP or building a system internally.

©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