Skip to Content
ReferenceAPI referenceGeo Locations

List the busiest IPs at one location

GET
/api/v1/geo-locations/{location_id}/top-ips

Returns the client IPs with the most events at the location in the range, most first. The items carry no location. An unknown location_id gets an empty list.

Authorization

cookiesession<token>

Session cookie authentication.

Path Parameters

location_id*integer

The location's id, from /api/v1/geo-locations or a GeoJSON feature's properties.id.

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 at one location, most first.

locationId*integer

The location's id, as /api/v1/geo-locations lists it.

topIps?array<>
uniqueIps*integer

Distinct client IPs at the location in the range.

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