List the IPs with the most geo events
Returns client IPs ordered by event count across every location, with a country, city and ASN. For an IP seen in several locations, countryCode and city each show one of them. A server filter reads the raw rows, which go back only ANALYTICS_RAW_RETENTION_DAYS days, 180 by default.
session<token>Session cookie authentication.
countryCodeIn?array<string>|Keep only these countries, as uppercase two-letter ISO 3166-1 codes such as NO. Repeat the parameter to pass more than one.
cityIn?array<string>|Keep only these cities, by the exact name GeoIP gives, such as Oslo. Repeat the parameter to pass more than one.
ipAddressIn?array<string>|Keep only these client IPs. Repeat the parameter to pass more than one. A value that is not an IP gets a 400.
ipAddressNotIn?array<string>|Leave out these client IPs. Repeat the parameter to pass more than one. A value that is not an IP gets a 400.
serverIn?array<string>|Keep only rows recorded under these server names. Repeat the parameter to pass more than one.
asnIn?array<integer>|Keep only these autonomous system numbers, such as 13335. Repeat the parameter to pass more than one. Rows without ASN data are left out.
asnNotIn?array<integer>|Leave out these autonomous system numbers. Repeat the parameter to pass more than one. Rows without ASN data stay in.
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 IPs to return, from 1 to 50. Defaults to 10.
1 <= value <= 5010Request fulfilled, document follows
application/json- response
Client IPs ordered by geo event count, most first.
items*array<>curl -X GET 'https://geometrikks.example.com/api/v1/geo-events/top-ips?fromTimestamp=2026-11-01T00%3A00%3A00Z&toTimestamp=2026-11-02T00%3A00%3A00Z'{ "items": [ { "asOrganization": "string", "asn": 0, "city": "string", "countryCode": "string", "eventCount": 0, "ipAddress": "string" } ]}List the countries with the most geo events GET
Returns countries ordered by event count, with the distinct IPs from each. A server filter reads the raw rows, which go back only ANALYTICS_RAW_RETENTION_DAYS days, 180 by default.
List the stored locations GET
Returns every location GeoMetrikks has resolved, paged with `currentPage` and `pageSize`. It takes no time range or filters. Pass an item's `id` to `/api/v1/geo-locations/{location_id}/top-ips`.