Skip to main content
The Roster endpoints return live booking data aggregated from Georgia county jails. Records are refreshed every 30–60 minutes directly from source jail management systems, giving you near-real-time visibility into new bookings, active holds, and recent releases. Use these endpoints to power inmate lookup tools, automate monitoring workflows, or feed downstream analytics pipelines.

​
GET /roster

List and filter inmate booking records across all available counties. Results are paginated and sorted by booking_date descending by default.

​
Query Parameters

​
string
The county name slug to filter results by (e.g., "clayton", "fulton"). Omit this parameter to search across all available counties.
​
string
Partial name search applied against the inmate’s full name. Case-insensitive. For example, "john doe" will match "JOHN DOE" and "Doe, John".
​
string
Filter by inmate booking status. Accepted values: "booked" or "released".
​
string
Return only records with a booking_date on or after this date. Must be a valid ISO 8601 date string, e.g. "2024-01-15".
​
string
Return only records with a booking_date on or before this date. Must be a valid ISO 8601 date string, e.g. "2024-06-30".
​
integer
default:"50"
Maximum number of records to return per page. Minimum: 1. Maximum: 200.
​
integer
default:"0"
Number of records to skip before returning results. Use with limit to paginate through large result sets.

​
Response

​
Response Fields

​
integer
The total number of records matching your query across all pages.
​
integer
The limit value applied to this response.
​
integer
The offset value applied to this response.
​
array
An array of inmate booking objects. May be empty if no records match your filters.
​
string
The unique DocketStream identifier for this booking record (e.g., "cltn-2024-00123").
​
string
The inmate’s full name as reported by the county jail.
​
string
Date of birth in YYYY-MM-DD format.
​
string
Display name of the county where the individual is or was booked.
​
string
ISO 8601 timestamp of when the individual was booked.
​
string | null
ISO 8601 timestamp of release, or null if the individual is still booked.
​
array of strings
List of charge descriptions associated with this booking.
​
number | null
Total bond amount in USD, or null if no bond has been set.
​
string
Current booking status: "booked" or "released".
​
string | null
Fully-qualified URL to the inmate’s mugshot image, or null if unavailable. Requests to this URL must also include your Authorization header.

​
GET /roster/

Retrieve the complete booking record for a single inmate by their DocketStream record ID. This endpoint returns all fields from the list response plus an additional gdc_match object when a corresponding Georgia Department of Corrections record is found.

​
Path Parameter

​
string
required
The unique DocketStream record ID for the inmate booking. IDs are returned by GET /roster and follow the format {county-slug}-{year}-{sequence}.

​
Response

The response includes all fields from the /roster list response, plus:
​
object | null
When DocketStream identifies a matching GDC record, this object contains details of that match. Returns null if no GDC record is linked.
​
string
The GDC offender identifier for the matched record.
​
string
Match confidence level: "high", "medium", or "low".
​
boolean
true if DocketStream’s facial recognition confirmed a mugshot match between the roster record and the GDC record.
​
string
URL to the full GDC record via GET /corrections/{gdc_id}.
Roster data refreshes every 30–60 minutes. If you query a record immediately after a booking or release event, the status and release_date fields may not yet reflect the latest source data. For real-time notifications on status changes, configure a webhook instead.