Court runner alternative for county criminal searches
Check the county court itself, live, through one API call, and get back structured records with the court’s link and the time it was checked. Where a court has no online records, the answer says so by county, and that county alone goes to your courthouse researcher.
Updated November 22, 2026 · API changelog
POST /v1/criminal/search
{
"query": { "firstName": "Jordan", "lastName": "Rivera", "dob": "1988-04-12" },
"geography": { "county": "OH:Franklin" },
"recordKinds": ["court"],
"live": { "jurisdictions": [{ "county": "OH:Franklin" }] }
}coverage.geography.countiesWithoutSource.Court runner services: how a county search works today
A county criminal search ordered from a researcher network is a chain of people. Each link adds time and a fee, and each is a place where the answer can be typed wrong.
A screening company sends the subject’s name, date of birth and county to a wholesaler. The wholesaler assigns the county to a courthouse researcher, often called a court runner or public record retriever. In some courthouses the researcher searches a public terminal; in others they file a request and wait for a clerk to run it. Hits are read off the screen or the file and typed into the wholesaler’s system, checked by a quality team and returned.
The model exists for a good reason: most criminal cases in the US are filed in county courts, and for decades the only reliable way to see a county’s current record was to stand in its courthouse. Turnaround is commonly quoted in business days, the per-county price is a fee per search plus whatever access fee the court charges, and clerk-assisted counties run slower than terminal counties.
A growing share of county and state courts now publish their criminal index online. For those courts the step that needed a person, reading the current record at the source, can be done by software during your request. That is the part of the chain this page replaces. The county criminal records page explains why the county layer is the hard one.
| Step | Courthouse researcher | Live check by API |
|---|---|---|
| Order | Sent to a wholesaler, queued for a county | One POST /v1/criminal/search per county or ZIP radius |
| Reach the court | Travel, terminal time or a clerk request | The court system is asked during the request |
| Read the record | Read and typed by a person | Structured fields: case, charges, dispositions, dates |
| Prove it | A researcher’s note | sources[].recordUrl and lastCheckedAt on each record |
| No online records | The researcher still goes | Listed in countiesWithoutSource: send it to a runner |
| Court fees | Passed through on top | None on our invoice |
Digital court runner: what a live check at the source court does
Four steps, the first three inside one search: the stored answer is the baseline, the live block asks the court again, the response says who answered, and you route what is left.
- Name the county, not a code.
geographytakes a county ("OH:Franklin"or a FIPS code), a ZIP and a radius, a city or whole states. The server picks the court, jail and agency systems that cover that area. See search criminal records by place. - Ask the court again, live. The same geography object inside
live.jurisdictionsasks every county, city and regional system in that area that can answer live. Statewide and federal systems are added by their code from the jurisdictions catalog, because every live source is billed. - Read who answered.
sourceStatus[]has one row per system asked:ok,incompleteand the reason. A record confirmed live carriessources[].live: trueand a freshlastCheckedAt; a record the stored copy holds but the live check did not return is flagged, never silently kept or dropped. - Route the rest.
coverage.geography.countiesWithoutSourcenames each asked county with no court source of its own. Those, and any system that did not answer, are the only orders your researcher network still needs.
| Live check answer | What your team does |
|---|---|
| Court answered, record confirmed | Report it with the citation and check time |
| Court answered, no record | A defensible “not held there” for that court |
| Stored record not returned live | Flagged: review before anything is reported |
| Court did not answer | incomplete; not billed; retry or route to a runner |
| County has no online source | Listed in countiesWithoutSource; route to a runner |
The status codes and polling: live and async searches. What “complete” means: result completeness.
Court runner vs API: cost, turnaround and evidence
The two models side by side, without vendor names. Our side is the published price list; the runner side is how the industry commonly prices and quotes the work.
| Courthouse researcher network | Live court check by API | |
|---|---|---|
| Unit | Per county searched, per name | Per search: $0.15, plus $0.02 per system that answered live |
| Court access fees | Passed through, set by each court | None |
| Turnaround | Commonly quoted in business days; clerk-assisted counties run longer | Same call for up to two in-request systems; a polled job otherwise; on FCRA orders, 90% of criminal checks done in under 30 minutes |
| What comes back | Text keyed in by a person | JSON: case number, charges, statute, severity, disposition, dates |
| Evidence | Researcher’s notes | The court’s own link, check time, verification PDF, signed receipt on FCRA orders |
| Gaps | Implicit: a clear can mean the court was not reached | Explicit: countiesWithoutSource, sourceStatus[].incomplete |
| Counties with no online records | Covered: a person can go to the counter | Not covered: listed so you can send a researcher |
| Certified copies, archived files | Available | Not offered |
The honest reading: an API wins wherever a court publishes its criminal index online, and a researcher is still the only answer where it does not. Most programs end up with both, and the API decides which county goes where. Turnaround is compared on the how long does a background check take page.
When a courthouse researcher is still the right call
Five situations an API cannot reach. Each one is visible in the response, so none of them is a silent miss.
- A court with no online criminal index. Some counties keep their index on a courthouse terminal or behind the counter. The county is listed in
countiesWithoutSource; only a person can search it. - Records a court does not publish. Sealed, expunged and juvenile matters, and anything the court withholds from its public index, are not returned. That is the correct outcome for a report as well.
- Files that exist only on paper. Older cases that predate a court’s electronic index, and the case file behind an index entry, are a clerk request.
- Certified copies. A certified disposition for an adjudicator or a dispute is a courthouse product.
- A court that did not answer. A system that timed out or refused is
incompleteinsourceStatusand is not billed; retry it, or route it to a researcher if your deadline is today.
Live coverage is built jurisdiction by jurisdiction, so the list of counties in the API lane grows. The current list is in the criminal coverage reference and, by state, on the criminal records by state pages.
Court record retrieval routing: API first, runner by exception
A router your fulfilment system can run per order: one county search per address-history county, and a runner order only for counties the API cannot answer.
# Route each county in the address history: API first, a researcher only for the gaps.
import os, time, requests
BASE = "https://api.offendersearch.app" # an os_test_ key: https://sandbox.offendersearch.app
H = {"X-API-Key": os.environ["OFFENDERSEARCH_KEY"]}
def county_search(person, county):
body = {
"query": person,
"geography": {"county": county}, # "OH:Franklin" or a 5-digit FIPS
"recordKinds": ["court"],
"live": {"jurisdictions": [{"county": county}]},
}
r = requests.post(f"{BASE}/v1/criminal/search", json=body, headers=H, timeout=60)
data = r.json()
poll = data.get("poll")
while r.status_code == 202: # most live checks run as a job
time.sleep(5)
r = requests.get(f"{BASE}{poll}", headers=H, timeout=60)
data = r.json()
if r.status_code == 200:
data = data["result"]
return data
def route(person, counties):
for county in counties:
res = county_search(person, county)
geo = res["coverage"]["geography"]
gaps = {c["fips"] for c in geo["countiesWithoutSource"]}
incomplete = [s for s in res["sourceStatus"] if s.get("incomplete")]
if gaps or incomplete:
yield county, "runner", res # no online court record, or it did not answer
else:
yield county, "api", resThe router reads two fields. countiesWithoutSource is the list of asked counties with no court source of their own; sourceStatus[] says whether each system asked live answered. A county with neither problem is done in the API lane. Anything else becomes a runner order, with the API answer attached as the starting point.
Keep the two lanes in one audit trail: the API response carries the searchId, and a verification report can be rendered from it later. The step-by-step build is in the court records API tutorial, and the matching rules a reviewer needs are in criminal matching and date of birth.
Wholesale volume? Bulk criminal record search runs a list in one call against the stored answer; the live check is per search, so send the rows that must be confirmed one at a time.
Court runner alternative coverage by state
Statewide court sources, county jail rosters, prison systems and warrant systems by state. A live jurisdiction answers a search today.
The twelve states with the most live jurisdictions. Each state links to its criminal records by state page; the statewide criminal search page covers the state tier.
| State | Courts | County jail rosters (live / catalogued) | Prison system | Warrants |
|---|---|---|---|---|
| Kentucky | Statewide | 119 / 121 | Statewide | — |
| Texas | Statewide | 84 / 104 | Statewide | Statewide |
| Ohio | Statewide | 82 / 86 | Statewide | Statewide |
| South Carolina | Statewide | 72 / 73 | Statewide | Statewide |
| Indiana | Statewide | 70 / 74 | Statewide | — |
| Pennsylvania | Statewide | 69 / 71 | Statewide | Statewide |
| California | Statewide | 66 / 71 | Statewide | Statewide |
| New York | Statewide | 65 / 67 | Statewide | Statewide |
| Missouri | Statewide | 66 / 68 | Statewide | — |
| Montana | Statewide | 61 / 72 | Statewide | — |
| Virginia | Statewide | 60 / 62 | Statewide | Statewide |
| Florida | Statewide | 57 / 63 | Statewide | Statewide |
Jurisdictions in our catalogue as of 2026-11-08; a live jurisdiction answers a search today. Approximate, not an official figure. Showing the 12 states with the most live jurisdictions; the full list is in the criminal coverage reference.
Depth varies by state and by county. Read the list for the counties you order most before you move them, and keep a researcher for the ones it does not name.
Court runner alternative pricing
A call, the live checks that answered, and nothing for the ones that did not. No court fees, no minimum.
| Item | Price | Unit |
|---|---|---|
| County criminal search (stored answer) | $0.15 | per call, the first 2,000 in a calendar month |
| Live re-verification | +$0.02 | per completed live source, $2.00 ceiling per search; a source that did not answer is not billed |
| Volume rate | $0.11 | per call past 2,000 in a calendar month |
| Free to start | 25 calls | once per account, on production data, no card |
| Sandbox | $0 | 60 calls a minute and 2,000 a day per test key |
| FCRA order | $4.95 | per order; sex offender and criminal court search included, with no court fees or extra charges |
No minimum on search. The Map API has its own $300 monthly minimum. No seats, no platform fee, no per-state fee; a batch row is billed as one call.
Worked example: one county search in which two court systems answer live costs $0.15 + $0.04 = $0.19 if both answer. Volume pricing is on the pricing page and the background check API pricing breakdown.
Worked examples by volume: background check API pricing · every rate: pricing.
Court runner alternative questions
What operations and compliance teams ask before they move a county out of the runner queue.
Is this a replacement for every court runner we use?
No. It replaces the runner for the counties whose court records can be checked online, and it tells you, county by county, which ones those are. A county whose court publishes nothing online, or only on a courthouse terminal, still needs a researcher. Every response lists those counties in coverage.geography.countiesWithoutSource, so the hand-off is a field, not a guess.
How fast is a live court check compared with a courthouse search?
Up to two systems that can answer inside a request return in the same call (200). More systems, or a system that cannot answer in-request, run as a job you poll (202). On FCRA orders, 90% of criminal checks done in under 30 minutes. A courthouse search is commonly quoted in business days.
Are there court access fees on top?
Not on our side. The data API bills $0.15 a call and $0.02 per live source that answered, never more than $2.00 of live checks on one search. An FCRA order is $4.95 all in, with no court fees.
What does a runner return that the API does not?
Things that live only on paper or at the counter: a file a clerk pulls from storage, a certified copy, an answer from a court with no online index, and a clerk’s reading of an identifier the online index does not show. The API returns what the court publishes online, structured, with the court’s own link and the time it was checked.
What if the database copy shows a record the live check no longer returns?
The record is flagged as not returned by the live check (liveResult "not_found_live"), so your reviewer sees the disagreement instead of a silent drop. Inside an FCRA order the rule is stricter: a record is furnished only when the live check confirms it, and one the court no longer shows is withheld as not_current_at_source.
Can we start with a few counties?
Yes. Send the counties you route most often, read countiesWithoutSource and sourceStatus on each answer, and move a county out of the runner queue once its answers come back complete. The sandbox is free with an os_test_ key, and 25 production calls are free with no card.
Is a search on the data API a consumer report?
No. The standard key returns a public-records lookup and the response says so. A result that will be used for a hiring, tenant, credit or insurance decision runs as an order through FCRA Partner Access, which runs the live checks, the controls and the evidence as part of the order.
County criminal search and FCRA 613 pages
The two pages beside this one: the search request itself, and the compliance reason it is ordered.
County criminal search API
The request, the response and the coverage block for a county search, field by field.
County criminal search API ›FCRA 613 compliance
Strict procedures for public records: verify a database hit at its source court before it is reported.
FCRA 613 compliance ›Criminal record verification API
The live block on any search, what it bills and the provenance on each record.
Criminal record verification API ›Learn the API by example
Runnable guides that use this endpoint as the worked example.
All guides: Learn APIs by example · reference: developer docs · packages: SDKs and CLI.
Related court record API pages
The rest of the developer surface, one anchor per page.
Test a court runner alternative on your own counties
Send the counties you order most with a live block, read countiesWithoutSource, and see which ones leave the runner queue. The sandbox is free.
The OffenderSearch APIs
One account, one key, one bill.