Skip to Content
ReferenceAPI referenceGeo Locations

List the busiest IPs with their main location

GET
/api/v1/geo-locations/top-ips

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.

Authorization

cookiesession<token>

Session cookie authentication.

Query Parameters

fromTimestamp*string

Start of the range, inclusive, as ISO 8601 with a timezone, such as 2026-11-01T00:00:00Z.

Formatdate-time
toTimestamp*string

End of the range, exclusive, as ISO 8601 with a timezone, such as 2026-11-02T00:00:00Z.

Formatdate-time
limit?integer

How many IPs to return, from 1 to 20. Defaults to 5.

Range1 <= value <= 20
Default5

Response Body

Request fulfilled, document follows

application/json
  1. response

The client IPs with the most events, each at the location where it had the most.

topIps?array<>
Example Request
curl -X GET 'https://geometrikks.example.com/api/v1/geo-locations/top-ips?fromTimestamp=2026-11-01T00%3A00%3A00Z&toTimestamp=2026-11-02T00%3A00%3A00Z'
Example Response
{  "topIps": [    {      "asOrganization": "string",      "asn": 0,      "eventCount": 0,      "ipAddress": "string",      "location": {        "city": "string",        "countryCode": "string",        "countryName": "string",        "id": 0,        "latitude": 0,        "longitude": 0      }    }  ]}