Billing

The two rates

A map request is one answer for one map view. It costs the same whether the view holds three people or three hundred.

A record open is the complete record behind one marker. Opening the same marker again is free. A new map request returns new marker ids, so opening that person from the new result is a new charge.

Accounts with high volume can be moved to a lower price for each record open, down to $0.005. Contact us.

What is free

Clusters and pins are never charged per person. A view that has not changed (HTTP 304), the status route and test mode are free.

• Clusters and pins themselves. A view with three hundred pins costs the same one map request as a view with three.
• Opening the same marker again. See Open a record.
• A 304. An unchanged view, asked for with If-None-Match.
• The status route. GET /v1/map/status.
• Test mode. Anything sent with sandbox=true.
• Any error response. A request that fails is not charged.

The monthly minimum

The $300 monthly minimum is applied toward everything the account uses that month, search included. A month with $110 of usage is billed $300; a month with $1,100 is billed $1,100.

• What counts toward it. Everything the account uses that month: map requests, record opens, and search calls on the same account.
• On its own it covers 150,000 map requests, or any mix of requests, record opens and searches that adds up to $300.
• It is not added to usage. You pay the larger of the two: your usage, or the minimum.

The first month and later months

For example, turn it on and use $1,100 in that month: $300 is charged on the day, and the month-end invoice is $800. Use $110: $300 is charged on the day, and the month-end invoice adds nothing.

Turning it off stops the routes at once and refunds nothing. Turning it back on in the same month costs nothing more. See Turn it on.

Five worked months

• Searches are priced here at $0.15 each, the published search price.
• The first row is a negotiated account in a period with the minimum waived, so it pays its usage only.
• The rows are later months. In the month you turn it on, the minimum is paid up front and the month-end invoice is the rest.

Rounding

Each line is rounded once, on the month’s total, not on each call. Map requests are rounded down to the cent. Record opens are rounded to the nearest cent.

Where to see usage

GET /v1/map/status returns this month’s map requests, record opens and their cost so far. It is free. The dashboard shows the same numbers under Map API.

curl https://api.offendersearch.app/v1/map/status \
  -H "X-API-Key: $OFFENDERSEARCH_KEY"

{
  "enabled": true,
  "paused": false,
  "pinMinZoom": 13,
  "nameMinZoom": 15,
  "maxMarkers": 300,
  "maxTilesPerRequest": 64,
  "markerIdTtlSeconds": 86400,
  "rates": {
    "requestUsdPer1k": 2,
    "recordOpenUsd": 0.015
  },
  "minimumUsd": 300,
  "minimumAppliesThisMonth": true,
  "minimumPaidThisMonthUsd": 300,
  "usageThisMonth": {
    "periodStart": "2026-10-01",
    "requests": 40000,
    "recordOpens": 2000,
    "requestsUsd": 80,
    "recordOpensUsd": 30,
    "estimatedUsd": 110
  },
  "sweep": {
    "tilesToday": 412,
    "tilesPerDay": 20000,
    "endUserTilesPerDay": 2000
  }
}