How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Offendersearch API Admin API

The Admin API from Offendersearch API — 11 operation(s) for admin.

Offendersearch API Admin API is one of 16 APIs that Offendersearch API publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Admin. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

This API exposes 12 operations across 11 paths, and defines 11 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://api.offendersearch.app.

12 operations 11 paths 11 schemas 8 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.offendersearch.app
Authentication
API Key, HTTP Bearer, API Key, API Key
Resource Areas
1

Authentication & Security 4

Offendersearch API Admin API declares 4 security schemes for authenticating requests. An API key is passed in the header as X-API-Key (ApiKeyAuth). It accepts HTTP bearer tokens (BearerAuth). An API key is passed in the query as key (QueryKeyAuth). An API key is passed in the header as X-Admin-Key (AdminAuth). By default, every request must be authenticated.

  • ApiKeyAuth — Customer API key. Primary auth for search/records/compat/proof.
  • BearerAuth — Signed session token (HMAC-SHA256). Auth for account/dashboard endpoints; also accepted by POST /v1/search and the compat endpoint.
  • QueryKeyAuth — API key passed as ?key= — offenders.io demo mode (compat endpoint only).
  • AdminAuth — Internal admin credential — separate from customer API keys.

Paths & Operations 12

Across 11 paths, the API surfaces 12 operations — 8 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.

Admin 12
GET
/v1/admin/accounts
List all accounts (admin console)
→ 200401
GET
/v1/admin/warm-queries
List warm queries (curated + top-derived) with hit stats
→ 200401
POST
/v1/admin/warm-queries
Add or remove a curated warm query
body → 200401
POST
/v1/admin/warm
Trigger a cache-warming run now (keeps the store hot)
body → 200401
GET
/v1/admin/cache-stats
Cache hit rate, hot-set size, last warm run, staleness
→ 200401
GET
/v1/admin/scraper-health
Per-scraper performance diagnostics (for humans and AI agents)
1 param → 200401
GET
/v1/admin/scraper-runs
Recent structured run events (tail) for diagnostics
2 params → 200401
POST
/admin/ingest
Trigger the nightly cache-refresh ingest run (background)
2 params body → 202401
POST
/admin/ingest/rerun-failures
Re-pull only the states whose latest ingest run errored
1 param → 202401
GET
/admin/ingest/status
Per-registry nightly-ingest freshness (alias: /admin/freshness)
1 param → 200401
GET
/admin/freshness
Alias of /admin/ingest/status
1 param → 200401
GET
/admin/ingest/report
Latest per-run ingest report
→ 200401

Schemas 11

The contract defines 11 schemas that model the data the API accepts and returns. The most detailed are Query (24 properties), IngestRegistryRow (15 properties), ScraperRun (11 properties), AdminAccount (7 properties). Each schema is shown below with its type and property counts.

WarmQuery
object
An internal warm query (kept hot). curated or top-derived.
5 properties
Error
object
Standard FastAPI error body.
1 property
AdminAccount
object
7 properties
WarmRunResult
object
5 properties
Query
object
The person/location query. All fields are optional; supply what you have. DOB/age drive the match-state (see Record.dobVerification). offenders.io parity filte…
24 properties
IngestRegistryRow
object
15 properties
IngestReport
object
Latest per-run ingest report. When no run has produced one yet, only available:false (+ note/reportDir) is returned.
3 properties
ScraperRun
object
One scraper call within a search — the atomic diagnostic record.
11 properties
ScraperHealth
object
2 properties
CacheStats
object
5 properties
IngestStatus
object
Per-registry nightly-ingest freshness view (GET /admin/ingest/status).
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

offendersearch-api-admin-api-openapi.yml Raw ↑

Other APIs Offendersearch API publishes across the network.

Offendersearch API Account API
Offendersearch API Auth API
Offendersearch API Batch API
Offendersearch API Billing API
Offendersearch API Compat API
Offendersearch API Keys API
Offendersearch API Proof Docs API
Offendersearch API Records API
Offendersearch API Report API
Offendersearch API Search API
Offendersearch API Searches API
Offendersearch API Sources API
Where this information came from

This is an independent, third-party profile of Offendersearch API Admin API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.