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.appThe 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.
| Product | Type | Status | Price |
|---|---|---|---|
| Sex-offender | person | Live | $3 / month |
| Criminal | person | Live | $3 / month |
| Sex-offender | location | Live | $10 / month |
| Criminal | location | Coming soon | $10 / month |
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.
// 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.
curl -X DELETE "https://api.offendersearch.app/v1/monitors/mon_b8f40d7afb9dc0d8" \
-H "X-API-Key: $OFFENDERSEARCH_KEY"