---
title: "List all honeytokens events"
method: GET
path: "/v1/honeytokens_events"
tags: ["Honeytokens Events"]
---

# List all honeytokens events

`GET /v1/honeytokens_events`

List events related to all honeytokens of the workspace.

## Query parameters

- `cursor` string
- `per_page` integer
- `ordering` 'triggered_at' | '-triggered_at'
- `honeytoken_id` string, uuid
- `status` 'open' | 'archived' | 'allowed'
- `ip_address` string
- `tags` string — Comma-separated list of tags to filter on
- `search` string

## Headers

- `X-Privacy-Mode` 'true' | 'false'

## Response `200`

Honeytokens Events List

- object[]
  - `id` string, uuid
  - `honeytoken_id` string, uuid — Id of the related Honeytoken.
  - `triggered_at` string, date-time — The time on which the honeytoken was triggered. Null if the honeytoken was never triggered.
  - `gitguardian_url` string
  - `status` 'open' | 'closed' — Status of the honeytoken event.
  - `ip_address` string — IP address from which the event originates.
  - `action` string — The action made through the honeytoken.
  - `data` object — An object with additional data related to the event
  - `tags` string[]

## Other responses

- `400` — Invalid data
- `401` — Invalid API key
- `503` — API under maintenance

---

[API](https://skmtc.net/gitguardian/apis/gitguardian-api.md) · [All operations](https://skmtc.net/gitguardian/apis/gitguardian-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitguardian/gitguardian-api/revisions/511b067cdcb1/schema)