{ "openapi": "3.0.3", "info": { "title": "Georgia Prisoners' Speak \u2014 Public Data API", "version": "1.0.0", "description": "Public, read-only data on Georgia's prison system from Georgia Prisoners' Speak (GDC Accountability Project, Inc., a 501(c)(3) nonprofit newsroom): population statistics, facilities, mortality context, parole statistics, quotes, articles, and spending. No authentication required. Please cite Georgia Prisoners' Speak (gps.press) when using this data. Machine-readable page twins: append .md to any gps.press page URL. Site guide for AI systems: https://gps.press/llms.txt", "contact": { "name": "Georgia Prisoners' Speak", "email": "accountability@gps.press", "url": "https://gps.press" }, "license": { "name": "CC-BY-4.0", "url": "https://creativecommons.org/licenses/by/4.0/" } }, "servers": [ { "url": "https://gps.press/wp-json/gps/v1", "description": "WordPress REST namespace \u2014 primary data endpoints" } ], "paths": { "/friday-report": { "get": { "operationId": "getFridayReport", "summary": "Latest weekly GDC population snapshot", "description": "GDC's Friday Report: total custody, facility-type breakdowns, and jail backlog for the most recent week.", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/friday-report/dates": { "get": { "operationId": "listFridayReportDates", "summary": "Available Friday Report dates", "description": "Available Friday Report dates", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/friday-report/trends": { "get": { "operationId": "getFridayReportTrends", "summary": "Weekly population trend series", "description": "Weekly population trend series", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/friday-report/compare": { "get": { "operationId": "compareFridayReports", "summary": "Compare two Friday Report dates", "description": "Compare two Friday Report dates", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/monthly-report": { "get": { "operationId": "getMonthlyReport", "summary": "Latest GDC monthly statistical profile", "description": "Latest GDC monthly statistical profile", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/monthly-report/dates": { "get": { "operationId": "listMonthlyReportDates", "summary": "Available monthly report dates", "description": "Available monthly report dates", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/monthly-report/trends": { "get": { "operationId": "getMonthlyReportTrends", "summary": "Monthly statistical trend series", "description": "Monthly statistical trend series", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/monthly-report/compare": { "get": { "operationId": "compareMonthlyReports", "summary": "Compare two monthly reports", "description": "Compare two monthly reports", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/statistics": { "get": { "operationId": "getStatistics", "summary": "Current GDC system statistics", "description": "Population, demographics, and health statistics for the Georgia prison system.", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/facilities": { "get": { "operationId": "listFacilities", "summary": "All Georgia correctional facilities", "description": "The ~90 GDC facilities with type, security level, location, population, and capacity.", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/facility/{slug}/health-inspections": { "get": { "operationId": "listFacilityHealthInspections", "summary": "Health inspections for one facility", "description": "Health inspections for one facility", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Facility slug, e.g. phillips-state-prison" } ] } }, "/facility/{slug}/health-inspections/latest": { "get": { "operationId": "getLatestFacilityHealthInspection", "summary": "Most recent health inspection for one facility", "description": "Most recent health inspection for one facility", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Facility slug, e.g. phillips-state-prison" } ] } }, "/release-statistics": { "get": { "operationId": "getReleaseStatistics", "summary": "Annual prison release data", "description": "Annual prison release data", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/release-statistics/summary": { "get": { "operationId": "getReleaseStatisticsSummary", "summary": "Release data summary", "description": "Release data summary", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/release-statistics/years": { "get": { "operationId": "listReleaseStatisticsYears", "summary": "Years with release data", "description": "Years with release data", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/length-of-stay": { "get": { "operationId": "getLengthOfStay", "summary": "Length-of-stay data", "description": "Time served across 304 offenses and 34 years, from official GDC records.", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/length-of-stay/offenses": { "get": { "operationId": "listLengthOfStayOffenses", "summary": "Offenses in the length-of-stay dataset", "description": "Offenses in the length-of-stay dataset", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/length-of-stay/summary": { "get": { "operationId": "getLengthOfStaySummary", "summary": "Length-of-stay summary", "description": "Length-of-stay summary", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/length-of-stay/trends": { "get": { "operationId": "getLengthOfStayTrends", "summary": "Length-of-stay trends", "description": "Length-of-stay trends", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/drug-report": { "get": { "operationId": "getDrugReport", "summary": "Drug-related admissions data", "description": "Admissions to Georgia prisons by drug type, 2022\u20132025.", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/drug-report/trends": { "get": { "operationId": "getDrugReportTrends", "summary": "Drug admissions trends", "description": "Drug admissions trends", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/drug-report/years": { "get": { "operationId": "listDrugReportYears", "summary": "Years with drug admissions data", "description": "Years with drug admissions data", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/articles": { "get": { "operationId": "listArticles", "summary": "GPS published articles", "description": "Investigative reporting, testimony, and informational articles from Georgia Prisoners' Speak.", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/articles/{id}": { "get": { "operationId": "getArticle", "summary": "One article by ID", "description": "One article by ID", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ] } }, "/categories": { "get": { "operationId": "listCategories", "summary": "Article categories", "description": "Article categories", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/quotes": { "get": { "operationId": "listQuotes", "summary": "Sourced quotes about the Georgia prison system", "description": "4,000+ categorized quotes from officials, court records, news coverage, and firsthand accounts.", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/quotes/{id}": { "get": { "operationId": "getQuote", "summary": "One quote by ID", "description": "One quote by ID", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ] } }, "/quotes/categories": { "get": { "operationId": "listQuoteCategories", "summary": "Quote categories", "description": "Quote categories", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/quotes/stats": { "get": { "operationId": "getQuoteStats", "summary": "Quote collection statistics", "description": "Quote collection statistics", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/parole/annual": { "get": { "operationId": "getParoleAnnualSeries", "summary": "Georgia Parole Board annual statistics FY2001\u2013FY2025", "description": "The State Board of Pardons and Paroles' own annual-report series: releases to parole, supervision population, completion rates, revocations, and life-sentence parole decisions \u2014 every value page-cited to the source report. Assembled by GPS; the Board does not publish this as a series.", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } }, "servers": [ { "url": "https://api.gps.press", "description": "GPS Gateway API" } ] }, "/health": { "get": { "operationId": "getApiHealth", "summary": "Gateway API liveness check", "description": "Gateway API liveness check", "responses": { "200": { "description": "JSON payload", "content": { "application/json": { "schema": { "type": "object" } } } } } }, "servers": [ { "url": "https://api.gps.press", "description": "GPS Gateway API" } ] } } }