Home / The Justice Ledger / The Justice Ledger Specification
The Justice Ledger
Justice in the Numbers
Overview
The Justice Ledger is an open-source national criminal court and sentencing transparency specification designed to establish a comprehensive, searchable registry of criminal cases, judicial decisions, and sentencing outcomes across the United States. The system consolidates publicly available court records into standardized, verifiable records that enable users to examine how criminal cases are prosecuted, adjudicated, and sentenced across jurisdictions.
The specification defines a modular platform in which core modules provide case registration, judicial profiles, offense classification, sentencing records, AI-assisted analysis, statistical comparisons, and public reporting. Optional plugin modules extend the platform with additional data sources, legal research capabilities, advanced analytics, and integration services.
The Justice Ledger aims to improve public understanding of the justice system through accessible information, reproducible analysis, source verification, and transparent methodologies. Its AI capabilities assist in identifying unusual sentencing patterns, including potentially excessive or unusually lenient punishments, without treating statistical anomalies as automatic evidence of judicial misconduct.
Mission
To create a national, open-source public resource that documents criminal cases and sentencing outcomes, measures differences in judicial decisions, and supports informed examination of sentencing consistency, proportionality, and accountability.
Design Principles
- Transparency: Make documented court outcomes accessible through searchable, understandable records.
- Accuracy: Preserve authoritative sources and distinguish verified information from extracted or inferred data.
- Modularity: Organize functionality into independent core modules and optional plugin modules.
- Interoperability: Support standardized records across different court systems and jurisdictions.
- Explainable AI: Provide evidence, methodologies, confidence indicators, and supporting records for analytical findings.
- Human Oversight: Require appropriate review of uncertain extractions, disputed records, and consequential analytical findings.
- Privacy and Legal Compliance: Respect public-record restrictions, sealed records, juvenile confidentiality, applicable privacy requirements, and legally mandated redactions.
- Reproducibility: Make statistical methods, comparison criteria, and analytical assumptions inspectable.
- Open Source: Enable community collaboration, independent auditing, and compatible extensions.
Core Modules
National Criminal Case Registry
Maintain a centralized, searchable index of criminal cases from federal, state, county, and participating municipal courts.
Features:
- Assign unique internal identifiers to individual cases.
- Record official case numbers, court names, judicial districts, and jurisdictions.
- Capture filing dates, hearing dates, disposition dates, and sentencing dates.
- Record case status, including pending, resolved, appealed, reopened, and remanded cases.
- Link indictments, charging documents, judgments, sentencing orders, opinions, and available transcripts.
- Maintain historical records when source documents remain available.
- Detect duplicate records and associate related proceedings.
- Track case amendments, procedural developments, and subsequent dispositions.
- Preserve links to original public sources and document retrieval metadata.
- Clearly identify incomplete records and unavailable documents.
Judicial Registry and Profiles
Maintain structured profiles of judges associated with criminal cases and judicial decisions.
Features:
- Record judge names, court affiliations, jurisdictions, and publicly documented service histories.
- Associate judges with cases and decisions supported by source records.
- Provide searchable judicial case logs.
- Summarize sentencing outcomes by offense category, jurisdiction, and period.
- Display distributions of incarceration, probation, fines, restitution, and alternative sanctions.
- Compare judicial sentencing patterns against relevant peer groups.
- Track changes in sentencing patterns over time.
- Link statistical findings to the cases contributing to each calculation.
- Distinguish confirmed judicial actions from statistical interpretations.
- Document changes in judicial assignments and case attribution when reliable records are available.
Criminal Offense Classification
Establish a standardized framework for organizing criminal offenses across jurisdictions.
Features:
- Classify offenses into categories such as violent crime, property crime, drug offenses, financial crime, cybercrime, public-order offenses, and other recognized categories.
- Record offense names, statutory citations, offense degrees, and felony or misdemeanor classifications.
- Distinguish allegations, filed charges, amended charges, convictions, acquittals, and dismissed counts.
- Map jurisdiction-specific offenses to comparable national categories without erasing meaningful legal differences.
- Record applicable statutory penalty ranges and sentencing guidelines when authoritative sources are available.
- Maintain versioned classifications to account for legislative changes.
- Support multiple offenses and multiple defendants within a single proceeding.
- Document classification confidence and unresolved ambiguities.
- Preserve the original statutory terminology alongside standardized classifications.
Sentencing and Punishment Registry
Maintain detailed records of criminal penalties and related court-imposed sanctions.
Features:
- Record prison and jail sentences, including imposed duration and suspended portions.
- Document probation, supervised release, and other recorded supervision conditions.
- Capture fines, restitution, forfeiture, and other financial penalties.
- Record community service, treatment programs, diversionary dispositions, and alternative sanctions.
- Document house arrest, electronic monitoring, and other court-ordered restrictions where publicly documented.
- Distinguish concurrent and consecutive sentences.
- Record mandatory minimums, statutory maximums, and applicable guideline ranges.
- Capture time-served credits and pretrial detention credits when documented.
- Track sentence modifications, appeals, reversals, remands, and resentencing.
- Distinguish the original sentence from the final operative sentence.
- Separate court-imposed financial penalties from administrative fees and other costs where the records permit.
- Preserve the source and date supporting every recorded sentencing outcome.
AI-Assisted Document Processing
Use AI to assist in converting unstructured legal records into standardized, searchable data.
Features:
- Extract case identifiers, court names, judge names, dates, charges, dispositions, and sentencing terms.
- Process digital documents, PDFs, scanned records, and available text transcripts.
- Apply optical character recognition to scanned documents.
- Identify relationships between charging documents, judgments, and sentencing orders.
- Normalize inconsistent legal terminology across jurisdictions.
- Detect duplicate documents, conflicting dates, missing fields, and inconsistent sentencing information.
- Assign confidence scores to extracted information.
- Route low-confidence or contradictory results for human verification.
- Preserve extracted text and references to the original documents.
- Record the processing method, model version, extraction timestamp, and subsequent corrections.
- Prevent unverified AI-generated information from being presented as confirmed court findings.
Judicial Sentencing Anomaly Detection
Analyze sentencing patterns to identify outcomes that differ substantially from comparable cases and may warrant further examination.
Features:
- Detect potentially unusually harsh or lenient sentences relative to appropriately matched cases.
- Identify unusually high fines, restitution orders, incarceration terms, and probation durations.
- Flag uncommon punishment types for particular offenses.
- Identify sentences that appear outside applicable statutory ranges for legal verification.
- Compare judicial decisions against local, state, and national benchmarks where comparisons are meaningful.
- Analyze repeated deviations across a judge’s recorded caseload.
- Distinguish isolated outliers from recurring patterns.
- Examine differences between imposed sentences and applicable sentencing guidelines.
- Identify potentially inconsistent treatment of comparable cases.
- Track changes in sentencing patterns over time.
- Provide case-level explanations and links to supporting records.
- Display sample sizes, comparison criteria, statistical uncertainty, and confidence indicators.
- Allow reviewers to inspect the methodology and calculations behind each finding.
- Support independent validation of anomaly detection methods.
Anomaly detection must account for relevant contextual factors where reliable data is available, including offense severity, criminal history, plea agreements, aggravating and mitigating circumstances, statutory requirements, and jurisdictional differences. A statistical outlier must not automatically be classified as unfair, cruel, corrupt, or evidence of misconduct. Findings must be presented as analytical indicators requiring context and, where appropriate, further investigation.
Sentencing Comparison and Proportionality Analysis
Provide tools for comparing criminal cases and examining differences in punishments.
Features:
- Identify cases with comparable offenses, circumstances, and legal classifications.
- Compare sentence lengths, fines, restitution, probation, and alternative sanctions.
- Calculate mean, median, range, and distribution of sentencing outcomes.
- Display differences between statutory ranges, sentencing guidelines, and actual sentences.
- Distinguish initial sentences from outcomes following appeal or modification.
- Compare cases within the same jurisdiction before expanding comparisons nationally.
- Explain differences in legal standards across jurisdictions.
- Identify patterns that may warrant additional legal, academic, or policy research.
- Provide a “Does the Time Fit the Crime?” analysis view.
- Explain the limitations of comparing cases with incomplete or materially different circumstances.
- Avoid automatically assigning a single fairness score to complex judicial decisions.
Geographic and Jurisdictional Analysis
Provide geographic tools for examining criminal cases and sentencing trends across the United States.
Features:
- Display interactive maps of participating courts, case volumes, and sentencing outcomes.
- Support searches by state, county, city, judicial district, court, and other appropriate geographic identifiers.
- Compare sentencing patterns across neighboring jurisdictions.
- Identify regional differences in incarceration, fines, probation, and alternative punishments.
- Track changes in outcomes across locations and time periods.
- Compare local statistics with state and national benchmarks.
- Identify differences in charging, plea dispositions, and sentencing practices where reliable data exists.
- Account for population, case mix, legal standards, and reporting differences where relevant.
- Clearly distinguish geographic associations from evidence of causation.
Public Search and Case Discovery
Provide an accessible interface for locating cases, judicial decisions, and sentencing records.
Features:
- Full-text search across available court documents.
- Search by offense, judge, court, jurisdiction, date, sentence, and case status.
- Filter by incarceration duration, fine amount, punishment type, and disposition.
- Search by statutory citation and standardized offense category.
- Support advanced queries and combinations of search criteria.
- Provide related-case suggestions based on documented similarities.
- Display source links and record verification status.
- Support saved searches and reusable comparison groups.
- Export case summaries and citations for research and journalism.
- Clearly identify missing records, incomplete fields, and unverified information.
- Provide accessible navigation and understandable descriptions of legal terminology.
Research and Public Reporting
Provide public dashboards and analytical tools for researchers, journalists, legal professionals, and the public.
Features:
- Publish national and jurisdiction-specific sentencing statistics.
- Display judge-level sentencing summaries and historical trends.
- Analyze incarceration, fines, restitution, probation, and alternative sanctions.
- Report case volumes, dispositions, and available sentencing outcomes.
- Generate charts, tables, and geographic visualizations.
- Support custom comparisons and reproducible research queries.
- Export appropriately licensed datasets and analytical reports.
- Document filters, source coverage, calculation methods, and data limitations.
- Distinguish descriptive statistics from causal conclusions.
- Allow users to verify findings against underlying records.
- Identify data gaps and areas requiring further collection.
Data Integrity, Verification, and Corrections
Maintain the accuracy, traceability, and integrity of the national registry.
Features:
- Preserve source provenance for each substantive record.
- Maintain document hashes or equivalent integrity identifiers where appropriate.
- Record retrieval dates, source references, extraction history, and changes.
- Validate required fields and relationships between cases, judges, charges, and sentences.
- Identify conflicting records and route them for review.
- Allow authorized reviewers to correct inaccurate classifications and extracted data.
- Provide a documented public correction and dispute process.
- Maintain audit trails for changes to records and analytical results.
- Preserve historical versions without continuing to present superseded information as current.
- Track correction requests and their resolution status.
- Distinguish official court corrections from community-submitted suggestions.
- Support independent data-quality audits.
Privacy, Security, and Responsible Publication
Protect the integrity of the registry while respecting legal and ethical requirements.
Features:
- Exclude sealed records and legally restricted information from public publication.
- Respect juvenile confidentiality and applicable redaction requirements.
- Minimize unnecessary exposure of personal identifying information.
- Apply access controls to administrative and verification functions.
- Protect credentials, review workflows, and system configuration.
- Log administrative changes and sensitive operations.
- Prevent unauthorized alteration of verified source records.
- Provide procedures for handling legally required removals or corrections.
- Document the limitations of public records and AI-generated analysis.
- Avoid publishing unsupported allegations about judges, defendants, or other individuals.
- Ensure that publicly displayed conclusions remain traceable to supporting evidence.
Optional Plugin Modules
Court Record Ingestion Plugin
Extend data collection through compatible public court APIs, official court portals, bulk record repositories, and approved public datasets.
Features:
- Provide jurisdiction-specific import connectors.
- Support scheduled ingestion and incremental updates.
- Track source availability and ingestion failures.
- Apply source-specific validation and normalization rules.
- Respect access restrictions, terms of use, and applicable law.
- Support manual imports when automated access is unavailable.
Sentencing Law and Guidelines Plugin
Connect cases to applicable statutes, sentencing guidelines, and legislative history.
Features:
- Maintain links to authoritative legal sources.
- Record statutory penalty ranges and guideline provisions.
- Track effective dates and legislative amendments.
- Identify apparent discrepancies between recorded sentences and applicable legal ranges.
- Flag potential legal inconsistencies for qualified review.
- Preserve the law applicable at the time of the offense and sentencing.
Appellate Review Plugin
Track appeals and subsequent changes to criminal judgments.
Features:
- Associate appellate proceedings with original cases.
- Record affirmances, reversals, remands, and resentencing.
- Link appellate opinions and orders to affected sentences.
- Identify reasons for sentence modification when documented.
- Update current outcome summaries without erasing historical decisions.
- Distinguish procedural outcomes from substantive findings.
Sentencing Disparity Research Plugin
Support carefully controlled analysis of potential disparities across demographic groups and other relevant case characteristics.
Features:
- Analyze documented differences in outcomes where lawful and supported by reliable data.
- Account for case mix, offense severity, jurisdiction, and available mitigating or aggravating factors.
- Identify data limitations and possible confounding variables.
- Apply privacy safeguards and minimum sample-size requirements.
- Report uncertainty and distinguish association from causation.
- Support independent methodological review.
Anomaly Monitoring and Alerts Plugin
Notify users when new records materially change sentencing analyses.
Features:
- Monitor new cases and sentencing decisions.
- Detect changes in established statistical patterns.
- Generate alerts for unusual fines, sentences, or punishment types.
- Notify subscribers about changes in judicial trend reports.
- Include source links, comparison groups, and methodological explanations.
- Allow users to configure alert criteria and frequency.
- Prevent automated alerts from presenting unverified anomalies as established misconduct.
Open Data and API Plugin
Enable external applications, researchers, and developers to access registry information.
Features:
- Provide documented search and retrieval endpoints.
- Support standardized data exports.
- Publish schema definitions and data dictionaries.
- Enable reproducible queries and aggregate statistics.
- Apply appropriate rate limits and access controls.
- Preserve source attribution and licensing information.
- Separate public records, restricted information, and internal review metadata.
Data Verification and Corrections Plugin
Extend community participation in record validation and correction.
Features:
- Allow users to report inaccurate or incomplete information.
- Accept supporting citations to authoritative records.
- Route submissions to appropriate review queues.
- Track correction decisions and resolution history.
- Distinguish confirmed corrections from unresolved disputes.
- Prevent unverified submissions from automatically changing authoritative records.
Legislative Change Tracking Plugin
Monitor changes to criminal laws and sentencing requirements.
Features:
- Track amendments to criminal statutes and sentencing guidelines.
- Associate legal changes with relevant jurisdictions and effective dates.
- Identify affected offense classifications and comparison rules.
- Preserve historical legal definitions.
- Notify researchers when changes may affect ongoing analyses.
- Require source verification before updating legal references.
Specification Branding License (SBL)
Standard
- Fully AGPL-3.0+ compliant system.
- Copyleft enforced for network deployments.
- Required attribution:
- Roxanne Ardary
- https://www.roxanneardary.com/
Optional
- Specification Branding License (SBL)
- Attribution-free commercial deployment.
- Pricing based on scale, usage, and deployment scope.
- https://roxanneardary.com/the-justice-ledger/
License & Notice Requirements
The Justice Ledger is released under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
By contributing to any Open Arsenal project, you agree that your contributions will also be released under this license.
Please note the following:
- All contributions must comply with the AGPL-3.0+ terms.
- Under Section 7 of the license, all redistributions, forks, and derivative works must preserve attribution to Roxanne Ardary and roxanneardary.com.
- The Justice Ledger specifications are free to use with attribution. A Specification Branding License can be negotiated upon request.
- The project’s
notice.mdfile tracks attribution requirements and contributor acknowledgments. Any update that adds new contributors or modifies attribution should also updatenotice.md. - When submitting a pull request, ensure that any new files maintain the attribution headers where applicable.
- Network-deployed versions of this software must also remain fully AGPL-3.0+ compliant, including exposure of source code modifications when applicable under the license.
For full legal details, please refer to the AGPL-3.0+ license and the project’s notice.md file.
Notice – The Justice Ledger
Attribution Requirement: Under Section 7 of the AGPL 3.0+ license, all redistributions, forks, and derivative works, including network-deployed versions of this project, must provide attribution to Roxanne Ardary and roxanneardary.com.
Contributors
This file tracks contributors and their specific contributions to the project.
- Roxanne Ardary, roxanneardary.com – October 28, 2026
Created the repository for The Justice Ledger. Developed the project concept for an open-source national criminal court and sentencing registry that uses AI to structure court records, compare sentencing outcomes, and identify unusual judicial sentencing patterns to promote transparency and accountability. - [Add other contributors here] – [Date]
[Describe contribution in one sentence]
License – The Justice Ledger
This repository is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
Key Points:
- You are free to use, modify, and distribute the code.
- All redistributions, forks, and derivative works or network-deployed versions must also be licensed under AGPL-3.0+ and provide attribution to Roxanne Ardary and roxanneardary.com as required under Section 7 of the license.
- The software is provided “as is,” without warranty of any kind.
For the full license text, see GNU AGPL-3.0 License.


