{"openapi":"3.1.1","info":{"title":"Federal sentencing by district and offense: individuals sentenced, prison rates and sentence lengths, fiscal years 2021 to 2025: data API","version":"v1","summary":"Static, read-only JSON and CSV files. No key, no sign-up. CORS open.","description":"Federal sentencing by district and offense: individuals sentenced, prison rates and sentence lengths, fiscal years 2021 to 2025: The U.S. Sentencing Commission's counts of individuals sentenced in federal court for the nation and each federal judicial district, overall and by type of offense (drug trafficking, firearms, fraud, immigration and 26 others): how many were sentenced, the share sentenced to prison, the average and median sentence in months (prison plus alternative confinement, probation as zero), and the shares convicted by guilty plea and after trial. Built from the Commission's public datafiles without individual identifiers, reduced to cell counts; each district and offense listed had 10 or more individuals in the latest year.\n\nProbative is a marketing firm, not a law firm; not legal advice. Every JSON response starts with a \"meta\" object holding the credit line, citation, DOI and license (CC BY 4.0).","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"contact":{"name":"Probative Growth","url":"https://probativegrowth.com/contact/","email":"hello@probativegrowth.com"}},"servers":[{"url":"https://probativegrowth.com"}],"externalDocs":{"description":"How to use the API and the MCP server","url":"https://probativegrowth.com/resources/rules-api/"},"paths":{"/data/v1/federal-sentencing/index.json":{"get":{"summary":"Federal sentencing by district and offense: individuals sentenced, prison rates and sentence lengths, fiscal years 2021 to 2025: index","description":"federal-sentencing: meta, summary and what the dataset holds","parameters":[],"responses":{"200":{"description":"Federal sentencing by district and offense: individuals sentenced, prison rates and sentence lengths, fiscal years 2021 to 2025: index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["federal-sentencing"]}},"/data/v1/federal-sentencing/changes.json":{"get":{"summary":"Federal sentencing by district and offense: individuals sentenced, prison rates and sentence lengths, fiscal years 2021 to 2025: confirmed changes","description":"federal-sentencing: confirmed changes, newest first","parameters":[],"responses":{"200":{"description":"Federal sentencing by district and offense: individuals sentenced, prison rates and sentence lengths, fiscal years 2021 to 2025: confirmed changes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["federal-sentencing"]}},"/data/v1/federal-sentencing/jurisdictions/{key}.json":{"get":{"summary":"Federal sentencing by district and offense: individuals sentenced, prison rates and sentence lengths, fiscal years 2021 to 2025: one jurisdiction","description":"federal-sentencing: the records for one jurisdiction","parameters":[{"name":"key","in":"path","required":true,"description":"The jurisdiction key, uppercase","schema":{"type":"string"},"example":"AK"}],"responses":{"200":{"description":"Federal sentencing by district and offense: individuals sentenced, prison rates and sentence lengths, fiscal years 2021 to 2025: one jurisdiction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["federal-sentencing"]}},"/data/v1/federal-sentencing/federal-sentencing.csv":{"get":{"summary":"Federal sentencing by district and offense: individuals sentenced, prison rates and sentence lengths, fiscal years 2021 to 2025 as CSV","description":"federal-sentencing: every record (credit line in README.txt)","parameters":[],"responses":{"200":{"description":"Federal sentencing by district and offense: individuals sentenced, prison rates and sentence lengths, fiscal years 2021 to 2025 as CSV","content":{"text/csv":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["federal-sentencing"]}},"/data/v1/federal-sentencing/federal-sentencing.json":{"get":{"summary":"Federal sentencing by district and offense: individuals sentenced, prison rates and sentence lengths, fiscal years 2021 to 2025: every record","description":"federal-sentencing: every record in one file","parameters":[],"responses":{"200":{"description":"Federal sentencing by district and offense: individuals sentenced, prison rates and sentence lengths, fiscal years 2021 to 2025: every record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["federal-sentencing"]}},"/data/v1/federal-sentencing/search.json":{"get":{"summary":"Federal sentencing by district and offense: individuals sentenced, prison rates and sentence lengths, fiscal years 2021 to 2025: keyword index","description":"federal-sentencing: id, key, status and text of every record","parameters":[],"responses":{"200":{"description":"Federal sentencing by district and offense: individuals sentenced, prison rates and sentence lengths, fiscal years 2021 to 2025: keyword index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["federal-sentencing"]}},"/data/v1/federal-sentencing/README.txt":{"get":{"summary":"Credit line, citation and columns","description":"federal-sentencing: the CSV sidecar","parameters":[],"responses":{"200":{"description":"Credit line, citation and columns","content":{"text/plain":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["federal-sentencing"]}}},"components":{"schemas":{"Meta":{"type":"object","description":"Credit line, citation, DOI, version, license and disclaimer. Present in every response.","required":["dataset","version","license","attribution","disclaimer","url"],"properties":{"dataset":{"type":"string"},"title":{"type":"string"},"version":{"type":"string"},"doi":{"type":"string"},"doiUrl":{"type":"string"},"conceptDoi":{"type":"string"},"license":{"type":"string","const":"CC BY 4.0"},"licenseUrl":{"type":"string"},"attribution":{"type":"string"},"citation":{"type":"string"},"disclaimer":{"type":"string"},"notice":{"type":"string"},"lastChecked":{"type":"string"},"url":{"type":"string"},"humanUrl":{"type":"string"},"statusCodes":{"type":"object"}}},"Source":{"type":"object","description":"Who to credit and how: publisher, the dataset page, version, license and the standard citation string. On every dataset file with a meta object (the catalog lists it per dataset).","required":["publisher","page","version","license","citeAs"],"properties":{"publisher":{"type":"string","const":"Probative Growth"},"page":{"type":"string","description":"The dataset page to cite and link"},"version":{"type":"string"},"license":{"type":"string","const":"CC BY 4.0"},"citeAs":{"type":"string","description":"Probative Growth, <dataset title>, <year>, <DOI link or dataset page>"}},"additionalProperties":false},"Envelope":{"type":"object","required":["meta"],"properties":{"meta":{"$ref":"#/components/schemas/Meta"},"source":{"$ref":"#/components/schemas/Source"}},"additionalProperties":true}}}}