Skip to Content
ReferenceAPI referenceAccess Logs

List the filter values in the access logs

GET
/api/v1/access-logs/facets

Returns every country, city, host, server name, log format and ASN the access logs hold, to fill the list filters. It reads the daily aggregates, so values stay listed after their raw lines are gone.

Authorization

cookiesession<token>

Session cookie authentication.

Response Body

Request fulfilled, document follows

application/json
  1. response

The values the access log filters can take, each list sorted.

asns*array<>

Sorted by organization, with the ones that have none last.

cities*array<string>
countries*array<>

Sorted by name.

hosts*array<string>

The Host header values the lines carry.

logFormats*array<string>

The log formats the lines were read with, such as nginx or traefik-json.

servers*array<string>

The server names that recorded access logs.

Example Request
curl -X GET 'https://geometrikks.example.com/api/v1/access-logs/facets'
Example Response200
{  "asns": [    {      "asn": 0,      "organization": "string"    }  ],  "cities": [    "string"  ],  "countries": [    {      "code": "string",      "name": "string"    }  ],  "hosts": [    "string"  ],  "logFormats": [    "string"  ],  "servers": [    "string"  ]}