Monitoring API · v1.0.0

Billing — one predicate, one charge

The price matrix, the one-predicate-one-charge rule, and when cancelling ends the charge.

Livehttps://api.offendersearch.appSandboxhttps://sandbox.offendersearch.app

The price matrix

A monitor is a flat monthly charge. 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 charges.

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 monitors. Every monitor that is still active when the month’s invoice is prepared is charged its full price from the matrix above, and the monitors are totalled on one Monitoring line.

Cancelling and proration

Cancel a monitor with DELETE /v1/monitors/{id}. Cancelling sets its status to canceled, and the monitor stops being evaluated at once. It is not charged on any invoice prepared after you cancel it, including the invoice for the month you cancel in. Charges are not prorated: a monitor that is active when an invoice is prepared is charged the full monthly price. A cancelled monitor stays readable, so its alert history is preserved.

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

Product overview