Skip to Content
ReferenceAPI referenceAccess Log Debug

List stored raw log lines

GET
/api/v1/access-log-debug

Returns stored raw log lines, newest first, each with the access log line it produced, paged with currentPage and pageSize. fromTimestamp and toTimestamp filter on when GeoMetrikks stored the line, inclusive at both ends, and searchString matches part of the raw line or the parse error, ignoring case unless searchIgnoreCase is false. Lines go back ANALYTICS_DEBUG_RETENTION_DAYS days, 30 by default.

Authorization

cookiesession<token>

Session cookie authentication.

Query Parameters

currentPage?integer

The page to return, counted from 1. Defaults to 1.

Range1 <= value
Default1
pageSize?integer

Rows per page, from 1 to 1000. Defaults to 50.

Range1 <= value <= 1000
Default50
searchString?string|null
searchIgnoreCase?|
Defaulttrue
fromTimestamp?|

Keep only lines GeoMetrikks stored at or after this time, as ISO 8601 with a timezone.

toTimestamp?|

Keep only lines GeoMetrikks stored at or before this time, as ISO 8601 with a timezone.

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. Lines that did not parse into an access log line have no value and drop out.

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. Lines that did not parse into an access log line have no value and drop out.

cityIn?array<string>|

Keep only these cities, by the exact name GeoIP gives, such as Oslo. Repeat the parameter to pass more than one. Lines that did not parse into an access log line have no value and drop out.

malformed?|

true keeps only malformed lines and false only well-formed ones. Leave it out to get both.

orderBy?string

The field to sort by, one of created_at, is_malformed, parse_error, log_format, timestamp, status_code, ip_address, host, country_code, city. timestamp is the request time from the line. Defaults to created_at, and any other value gets a 400. Lines without a value come last in both directions.

Default"created_at"
sortOrder?string

asc or desc. Defaults to desc.

Default"desc"
Value in"asc""desc"

Response Body

Request fulfilled, document follows

application/json
  1. response

One page of results. total counts the matches on every page, limit is the page size and offset is how many matches come before this page.

items?array<>
limit?integer

Maximal number of items to send.

offset?integer

Offset from the beginning of the query.

total?integer

Total number of items.

Example Request
curl -X GET 'https://geometrikks.example.com/api/v1/access-log-debug?fromTimestamp=2026-11-01T00%3A00%3A00Z&toTimestamp=2026-11-02T00%3A00%3A00Z'
Example Response
{  "items": [    {      "accessLogId": 0,      "city": "string",      "countryCode": "string",      "countryName": "string",      "createdAt": "2019-08-24T14:15:22Z",      "host": "string",      "id": 0,      "ipAddress": "string",      "isMalformed": true,      "logFormat": "string",      "method": "string",      "parseError": "string",      "rawFields": {        "fields": [          {            "group": "request_header",            "key": "string",            "storedAs": "string",            "value": "string"          }        ],        "format": "string"      },      "rawLine": "string",      "statusCode": 0,      "timestamp": "2019-08-24T14:15:22Z",      "url": "string",      "userAgent": "string"    }  ],  "limit": 0,  "offset": 0,  "total": 0}