Offendersearch
Monitoring API Reference

Billing — one predicate, one charge

The price matrix, the one-predicate-one-charge rule, and how cancelling prorates at period end.

Base URL https://api.offendersearch.app

The price matrix

A monitor is a flat monthly subscription. Price depends on the type — a person watch or a location watch — and every monitor watches exactly one product.

ProductTypeStatusPrice
Sex-offenderpersonLive$3 / month
CriminalpersonLive$3 / month
Sex-offenderlocationLive$10 / month
CriminallocationComing soon$10 / month
Criminal location monitoring is coming soon — it will arrive as location coverage across criminal records expands. A POST for it returns a not_yet_available acknowledgement and bills nothing. See Location monitoring.

One product, one predicate, one charge

This is the rule to build your billing model on: each monitor is one product, one predicate, and one charge. Criminal and sex-offender person-monitoring are two separate monitors, even for the same person. Watching one individual across both datasets means two monitors — one product: "sex-offender" and one product: "criminal" — and therefore two charges: $3 + $3 = $6 / month.

Two datasets = two monitors
// Watching Jordan Rivera across BOTH datasets = two monitors = $6/mo.

// Monitor 1 — $3/mo
{ "product": "sex-offender", "type": "person",
  "person": { "firstName": "Jordan", "lastName": "Rivera", "dob": "1988-04-12" },
  "channels": { "email": "alerts@example.com" } }

// Monitor 2 — $3/mo  (a separate POST, a separate mon_… id, a separate charge)
{ "product": "criminal", "type": "person",
  "person": { "firstName": "Jordan", "lastName": "Rivera", "dob": "1988-04-12" },
  "channels": { "email": "alerts@example.com" } }

There is no combined "watch everywhere" monitor. If you want one person covered across both datasets, create two monitors and expect two line items.

Invoicing

Monitor charges appear on the same monthly invoice as the rest of your account’s usage — the per-call search and live-verification charges from the other products sit alongside your monitor subscriptions. Each active monitor is one recurring monthly line item at the price in the matrix above.

Cancelling and proration

Cancel a monitor with DELETE /v1/monitors/{id}. Cancelling sets its status to canceled and stops billing at the end of the current period — the monitor keeps running until then and its charge is prorated, so you are billed only for the portion of the period it was active. A cancelled monitor stops being evaluated but stays readable, so its alert history is preserved.

DELETE /v1/monitors/{id}
curl -X DELETE "https://api.offendersearch.app/v1/monitors/mon_7f2a1c9e0b4d" \
  -H "X-API-Key: $OFFENDERSEARCH_KEY"