/api/v1/visits

Reading stored visits back from your own application.

GET /api/v1/visits
GET /api/v1/visits/<requestId>

Authentication#

The operator token, in the x-collect-token header.

Results are cut to the sites the caller may see. Any route that hands out visits, addresses or visitors makes the same cut.

The list#

curl 'https://hideguard.io/api/v1/visits?site=<siteId>&limit=100' \
  -H 'x-collect-token: <token>'

Returns a visits array, a summary block, and the sites the caller can see.

The site parameter narrows to one site, because the token itself does not.

One visit in full#

curl 'https://hideguard.io/api/v1/visits/<requestId>' \
  -H 'x-collect-token: <token>'

Returns the whole stored evidence plus that visitor's history.

What is stored#

Raw signals, never a verdict. The score and verdict in the reply are rebuilt at read time from the current model, so a better model re-describes all of history, and one visit can carry a different score today than it did yesterday.

See Verdict and score.