Documentation · API reference
GET
/api/v1/sites/{site}/visitors/{visitor}Everything held about one visitor
This page as Markdown, or in an AI chatMore ways to read this page
Everything held about one visitor.
# Everything held about one visitor
> tidekeeper's API reference: https://tidekeeper.eu/docs/api/get-sites-site-visitors-visitor
`GET /api/v1/sites/{site}/visitors/{visitor}`
Everything held about one visitor.
## Parameters
- `site` (in path, needed): A site's id or name
- `visitor` (in path, needed): The visitor's ID, v_ and 32 digits
## The answer
200, `VisitorDetail`: Everything held about one visitor (VI-06).
- `deleted_on` (string, needed): The day their data is deleted if they do not come back.
- `device` (string, needed)
- `joined` (list of JoinView, needed): IDs that were joined to this one, with when (VI-04).
- `note` (string, needed): Their first views, before they answered, are not here.
- `props` (list of PropView, needed)
- `records` (list of RecordView, needed)
- `refused` (list of string, needed): Properties the site sent that it had not declared.
- `requests` (list of RequestView, needed)
- `site` (string, needed)
- `state` (string, needed): `agreed` or `withdrew`.
- `visitor` (VisitorRow, needed)
- `visits` (list of VisitView, needed)
## Asking
```sh
curl https://tidekeeper.eu/api/v1/sites/example.org/visitors/{visitor} \
-H "Authorization: Bearer $TIDEKEEPER_TOKEN"
```
Parameters
- sitein the address
- neededA site's id or name
- visitorin the address
- neededThe visitor's ID, v_ and 32 digits
The answer
Status 200
VisitorDetail Everything held about one visitor (VI-06).
- deleted_on
- stringneededThe day their data is deleted if they do not come back.
- device
- stringneeded
- joined
- list of JoinViewneededIDs that were joined to this one, with when (VI-04).
- note
- stringneededTheir first views, before they answered, are not here.
- props
- list of PropViewneeded
- records
- list of RecordViewneeded
- refused
- list of stringneededProperties the site sent that it had not declared.
- requests
- list of RequestViewneeded
- site
- stringneeded
- state
- stringneeded`agreed` or `withdrew`.
- visitor
- VisitorRowneeded
- visits
- list of VisitViewneeded
Asking
curl https://tidekeeper.eu/api/v1/sites/example.org/visitors/{visitor} \ -H "Authorization: Bearer $TIDEKEEPER_TOKEN"
const answer = await fetch("https://tidekeeper.eu/api/v1/sites/example.org/visitors/{visitor}", { headers: { Authorization: `Bearer ${process.env.TIDEKEEPER_TOKEN}`, }, }).then((r) => r.json());