get_population_snapshot
Get population snapshot
Latest GDC population snapshot (the weekly 'Friday report'):
`total_in_gdc_custody` (every GDC bed type, including probation detention
centers and RSAT), the jail backlog, and the facility-type components.
The total is the ONLY population figure; the components are parts of it,
not alternative totals.
Takes no parameters.
get_system_statistics
Get system statistics
Headline statistics for the Georgia prison system: population,
mortality, demographics, facility counts, releases and health measures,
with the update date and data source GPS assembled them from.
Takes no parameters.
list_facilities
List facilities
List Georgia prison facilities with location, operator, security level,
capacity, population, warden and latest food-safety score.
Optional filters are applied to the public list after it is fetched:
facility_type (e.g. 'State Prison', 'Transitional Center', 'County
Prison'), county, name_contains, and active_only. Responses are paged:
`limit` (default 25) and `offset`; `next_offset` says where the rest begins.
Parameterslimitcountyoffsetactive_onlyfacility_typename_contains
get_facility_staff_roster
Get facility staff roster
Staff headcount and list for one GDC facility, from a GDC-produced roster.
Answers "how many staff work at X", "how many officers work there", "list the
staff at X". `slug` is the facility slug, e.g. 'dooly-state-prison' (use
list_facilities to find it).
`title` optionally filters by job title. GDC abbreviates heavily: correctional
officers appear as "Correctional Ofc", clerical staff as "Admin Support" or
"Admin Assistant". Try both the plain word and the abbreviation.
ALWAYS report the `observed` date alongside any figure from this tool. A roster
is a single-day observation, not a statement about who works there today.
A zero for a role is a finding about the roster rather than missing data: the
roster holds no nursing, physician or dental titles anywhere in GDC, which is
consistent with medical staffing being contracted rather than directly employed.
Do not assert that reason as established fact.
Parametersslugrequiredlimittitle
One facility's full public record plus its most recent state health
inspection, if GPS has one.
`slug` is the facility's gps.press slug, e.g. 'macon-state-prison'. Use
list_facilities to find it.
Parametersslugrequired
get_parole_statistics
Get parole statistics
Georgia parole decisions by year — the series GPS assembled from the
State Board of Pardons and Paroles' own annual reports, with the metric
definitions and the instruments note that says how they were built.
`metric` (exact name from the `metrics` list, e.g. 'cases_considered'),
`from_year` / `to_year` (fiscal years) filter the series. Paged: `limit`
(default 100 rows) and `offset`.
Parameterslimitmetricoffsetto_yearfrom_year
get_ocga_section
Get ocga section
Full text of a section of the Official Code of Georgia Annotated from
GPS's public mirror.
`section` is the bare citation without the 'O.C.G.A. §' prefix, e.g.
'9-14-42', '42-5-2', '17-9-4'.
Parameterssectionrequired
get_mortality_data
Get mortality data
Deaths in GDC custody since 2020 — yearly and monthly counts, cause-of-
death breakdown, deaths by facility, facility type, security level and age.
With no arguments this returns the whole published document plus a list of
its sections. `section` returns one section by name (e.g. 'YEARLY
STATISTICS', 'DEATHS BY FACILITY'); `year` filters the yearly and monthly
lines to that year; `facility_contains` filters the by-facility ranking AND returns that facility's cause-of-death breakdown.
Filters are matched against the published lines, which is why the matching
lines are returned verbatim rather than re-tabulated.
Parametersyearsectionfacility_contains
get_settlements_data
Get settlements data
What Georgia has paid to settle prison death and injury claims — the
'What Georgia Pays' analysis of state settlement records, returned as the
published markdown.
Takes no parameters.
get_contraband_incidents
Get contraband incidents
Incidents from GDC's own published contraband arrest reports (2010-present, ~1,600 incidents,
including reports that survive only in the Internet Archive; page: gps.press/contraband-data/):
one row per incident with GDC's wording verbatim, the people as GDC categorised them
(staff / officer / contract staff / visitor / civilian), the items, whether an arrest was
reported, and the GDC source URL. Filters: facility slug (e.g. dooly-state-prison), year,
actor_category (staff | visitor | civilian | officer | gdc_staff | contract_staff),
item_category (cellphone, tobacco, marijuana, methamphetamine, ...), arrest_made (yes|no|unstated),
q (text match). Structured rows name staff, officers and contract staff as GDC printed them; other people appear by category and role only. The narrative is GDC's own text.
Rows are long (a few thousand characters each): per_page defaults to 5 and is capped at 20;
use `page` to continue and the filters to narrow. `total` is the number of matches.
Parametersqpageyearfacilityper_pagearrest_madeitem_categoryactor_category
get_contraband_summary
Get contraband summary
Summaries of GDC's published contraband arrest reports. `by` = year | facility |
actor-category | role | item-category | stats. Optional facility slug / year filters (not for
stats). Counts arrests as GDC reported them; GDC's own running tally is not used because it is
not a consistent series across copies of the same report.
Parametersbyyearfacility
get_facebook_posts
Get Facebook posts
What people on Facebook are saying about Georgia's prisons: public posts in the Ga. Prisons Exposed
group and comments on GPS's own Facebook posts that GPS kept (families, formerly incarcerated people,
former officers, advocates), newest first, each with its author, date, link and label:
'first-hand or inside account' (something specific that happened, seen or lived by the author or told
by someone inside), 'opinion', 'idea for change', or 'news retold'. Filters: q (words), facility (a
prison name, e.g. "Telfair"), days (default 30, max 365), label (account | opinion | idea | news),
limit (default 10, max 60). `counts` gives items and people per label for the whole match.
These are the authors' own views and accounts, never GPS findings: attribute and link every quote.
Names of people in custody and GDC numbers are removed before the data leaves GPS.
Parametersqdayslabellimitfacility
list_historical_series
List historical series
GPS Historical Data (page: gps.press/historical-data/): the catalog of yearly series on Georgia's
prisons, 1925-present. Each series is ONE publisher's measure (GDC and Board of Corrections annual
reports, the Bureau of Justice Statistics, the State Board of Pardons and Paroles, DOJ, the AJC, UCLA
Law Behind Bars, the GPS mortality registry) with its definition, coverage and caveats. Topics:
deaths, homicides, suicides, violence, use_of_force, weapons, parole, time_served, lifers, population,
capacity, budget, escapes, staffing. Never splice two publishers' series into one trend.
Parameterstopic
get_historical_series
Get historical series
One GPS Historical Data series by year: every value with the source's own label, the source
(publisher, title, page, URL) and the exact quote it was checked against, plus the series'
definition BREAKS (never read one trend across a break). Get slugs from list_historical_series,
e.g. deaths-bjs-state-prisons, homicides-gdc-via-doj, los-pct-released-on-parole-gdc,
population-yearend-gdc-series, deaths-gps-registry (live). CSV: add ?format=csv to the REST URL.
Values are paged (`limit` default 25, `offset`); narrow with from_year/to_year/category/subgroup.
Parametersslugrequiredlimitoffsetto_yearcategorysubgroupfrom_year
search_historical_data
Search historical data
Find GPS Historical Data series and dated rule changes by words, e.g. "homicide", "parole",
"life", "AIDS", "population", "90%".
Parametersqrequired
get_historical_events
Get historical events
Dated changes to Georgia parole and sentencing rules and the court rulings on them, 1908-present
(the 1979 guidelines grid, the 1994-95 Sentence Reform Act, the 1998 90% policy, the 2005 Fulton
order voiding it, the 2006 and 2008 changes, HB 1176 in 2012), each with its source and quote.
topic = parole | sentencing | court.
Parameterstopicto_yearfrom_year
search_quotes
Search quotes
Search GPS's published quote collection — statements from incarcerated
people, families, officials and staff that GPS has already published.
`attribution_type` is 'named' or 'anonymous'. `category` is one of the
published categories (call with no arguments and read the results, or see
gps.press). Paginated: page starts at 1, per_page caps at 100.
Parameterspagesearchcategoryper_pageattribution_type
get_length_of_stay
Get length of stay
How long people actually serve in Georgia, by offense and year: average
sentence, years served, percentage of sentence served, share released on
parole, and the lifer figures — plus the trend summary.
`offense` is a case-insensitive substring of GDC's offense name (e.g. 'murder',
'burglary', 'drug'; also the four-digit offense code). With no `offense` the
all-crimes series is returned. `year` is the calendar year of release (e.g.
'2023'). Both filter on this server. Rows are newest year first and paged:
`limit` (default 30) and `offset`; `matched_offenses` lists what `offense`
matched. `summary_only` returns just the summary block.
Parametersyearlimitoffsetoffensesummary_only
get_drug_admissions
Get drug admissions
Admissions to Georgia prisons on drug offenses for the latest published
report year, broken down by sex, age band and related measures.
Takes no parameters.
Search gps.press — articles, data pages, research library topics and
facility pages — and get back ranked titles, URLs and summaries.
This reads the public /find/ results page. GPS publishes no JSON search
API, so results are parsed out of the rendered page; treat the ranking as
the site's own and follow each result's URL before citing it.
Parameterslimitqueryrequired
get_gps_guide
Get gps guide
GPS's orientation file for AI clients (llms.txt) — READ THIS FIRST.
Carries the things the data tools cannot: which figure to lead with when two are
defensible, how to label budget figures, the exact date of the DOJ findings report,
and the claims GPS has publicly corrected and will not repeat. Roughly 2,000 words.
The datasets give you accurate numbers. This is what keeps the sentence around the
number accurate too.
Takes no parameters.
Read any gps.press page as clean Markdown.
Every page on the site has a Markdown twin at the same URL with `.md` appended;
this fetches it. Accepts a full URL, a path, or a bare slug — '/vision2027/',
'vision2027', and the full https URL all work, with or without '.md'.
Covers articles, data pages, campaign pages and the intelligence briefings
(intelligence/facility/{slug}, intelligence/issue/{slug}).
Long pages are truncated; use `offset` and `limit` to page through one. Pair with
search_site() to find a page, then read it here rather than guessing its contents.
Parameterspathrequiredlimitoffset
list_intelligence
List intelligence
List GPS intelligence briefings — per-facility and per-issue analyses.
`kind` filters to 'facility' or 'issue'; `contains` filters on the slug.
Read any of them in full with get_page(), e.g.
get_page('intelligence/facility/dooly-state-prison').
Both kinds are discovered from GPS's public intelligence index pages; if the issue
hub cannot be read, `issues_note` says so in the payload.
Parameterskindcontains