Get map statistics

Aggregates across approved, non-disputed spots. Used by the public map's insights panel.

GET

https://deathspot.org/api/stats

View as Markdown

Returns

200

Statistics.

JSON

totalsobjectrequired
4 properties
- totalintegerrequired
  Approved spots on the map.
- confirmedintegerrequired
  Community-confirmed or moderator-verified spots.
- unverifiedintegerrequired
- this_weekintegerrequired
  Spots reported through the app in the last 7 days (excluding seed data).
byCategoryarray ofobjectrequired
2 properties
- categorymurderormob_actionorboda_gangorrobberyorstabbingorkidnapping+1 morerequired
  What happens at the spot: murder (killing), mob_action, boda_gang, robbery (robbery or snatching), stabbing (stabbing or hacking), kidnapping, other.
- countintegerrequired
byAreaarray ofobjectrequired
The 8 areas with the most spots.
3 properties
- areastringrequired
- countintegerrequired
- max_severityintegerrequired
  maximum: 5, minimum: 1

429

The caller exceeded a rate limit. Wait Retry-After seconds before retrying.

JSON

errorstringrequired
A human-readable message you can show to users.

500

Unexpected server error, usually because the database is unreachable.

{ "totals": { "total": 21, "confirmed": 21, "unverified": 0, "this_week": 0 }, "byCategory": [ { "category": "robbery", "count": 16 }, { "category": "boda_gang", "count": 4 }, { "category": "murder", "count": 1 } ], "byArea": [ { "area": "Kira, Wakiso", "count": 4, "max_severity": 4 }, { "area": "Rubaga", "count": 3, "max_severity": 3 } ] }