Skip to content

Deathspot UG API

The Deathspot UG API powers the public map. Use it to read danger spots, report new ones, confirm or deny existing spots, flag problems for moderators, and check a route for danger spots.

  • No API key. The public API is anonymous. Visitors are told apart by a salted, non-reversible hash of their IP address and user agent, which is used only for one-vote-per-spot and rate limits.
  • JSON in, JSON out. Send Content-Type: application/json on every POST.
  • Uganda only. Coordinates must fall inside Uganda's bounding box (latitude −1.6 to 4.3, longitude 29.5 to 35.1).
  • Rate limited. Every endpoint returns RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset and RateLimit-Policy headers, and 429 with Retry-After when you're over a limit. See the Rate limits guide.
  • Places, not people. Reports describe locations. Phone numbers in free text are replaced with [removed], and moderators delete anything that names or accuses a person.

Moderation (approving, hiding, editing and verifying spots) is not part of the public API. Moderators use the /admin panel.

Version: 1.0.0

Servers

  • https://deathspot.org
  • http://localhost:3000
Navigation

Type to search…

↑↓ navigate↵ selectEsc close