List the countries with the most events, unfiltered
Returns countries ordered by event count. Ranges over 24 hours read the location aggregates, which count whole hours or UTC days, from the one that holds fromTimestamp through the last one that starts before toTimestamp. /api/v1/geo-events/top-countries also counts unique IPs and takes filters.
session<token>Session cookie authentication.
fromTimestamp*stringStart of the range, inclusive, as ISO 8601 with a timezone, such as 2026-11-01T00:00:00Z.
date-timetoTimestamp*stringEnd of the range, exclusive, as ISO 8601 with a timezone, such as 2026-11-02T00:00:00Z.
date-timelimit?integerHow many countries to return, from 1 to 50. Defaults to 10.
1 <= value <= 5010Request fulfilled, document follows
application/json- response
Countries ordered by geo event count, most first.
topCountries?array<>curl -X GET 'https://geometrikks.example.com/api/v1/geo-locations/top-countries?fromTimestamp=2026-11-01T00%3A00%3A00Z&toTimestamp=2026-11-02T00%3A00%3A00Z'{ "topCountries": [ { "countryCode": "string", "countryName": "string", "eventCount": 0 } ]}Remove a retired server's location DELETE
Deletes the auto-detected location of a server you no longer run and answers 204. If the server's instance still runs, it records the location again at its next location refresh. A location that MAP_SERVER_LOCATIONS pins gets a 409. Needs a Read/write API key or a browser session.
List the busiest IPs with their main location GET
Returns client IPs, each with the location where it had the most events in the range. The ranking and `eventCount` use that one location's events only, so an IP spread over several locations ranks lower than its total suggests. The server ranks `limit` times 10 location and IP pairs before it drops repeated IPs, so the list can hold fewer than `limit` IPs while more exist.