# Retrieve an event name

`GET /v1/events/names/{name}`

Requires an API key with the `events:read` scope. [About keys and scopes](/docs/api/authentication)

How often the event arrived in the last 30 days, when it was last seen (`null` when no event of that name is held, so the name has never arrived or every one has passed retention), and the property keys its most recent 1,000 events carry, with their types and up to five sample values. Feeds the property pickers in segment and journey rules. An embed session gets no sample values unless minted with `includeAttributeValues`.

## Path parameters

- `name` (string, required, 1–128 characters)

## Returns

Returns `200 OK` with a `EventNameDetail` in `data`. Otherwise returns an error; [Errors](/docs/api/errors) lists every code and which to retry.

- `name` (string, required)
- `countLast30Days` (integer, required, min 0, max 9007199254740991) — Events in the last 30 days, counted up to 100,000.
- `lastSeenAt` (string | null, required, date-time) — When the latest event arrived.
- `properties` (object[], required) — Keys seen in the most recent 1,000 events, most common first.
  - `key` (string, required)
  - `types` (string[], required) — The value types seen under this key.
  - `samples` (string | number | boolean[], required) — Up to five distinct scalar values.
  - `seenIn` (integer, required, min 0, max 9007199254740991) — How many of the sampled events carry this key.
- `usedBy` (object, required) — What reads this event, up to 50 of each: journeys (trigger, exit conditions, waits and rules in their steps), segments and campaign audiences (event rules), and conversion goals.
  - `journeys` (object[], required)
    - `id` (string, required, uuid)
    - `name` (string, required)
    - `status` (string, required, one of `draft`, `active`, `paused`, `ended`)
  - `segments` (object[], required)
    - `id` (string, required, uuid)
    - `name` (string, required)
  - `campaigns` (object[], required)
    - `id` (string, required, uuid)
    - `name` (string, required)
    - `status` (string, required, one of `draft`, `scheduled`, `sending`, `sent`, `cancelled`)
  - `conversionGoals` (object[], required)
    - `id` (string, required, uuid)
    - `campaignId` (string | null, required, uuid)
    - `journeyId` (string | null, required, uuid)

## Example

```bash
curl https://api.kirora.io/v1/events/names/Weekend specials \
  -H "Authorization: Bearer $KIRORA_API_KEY"
```

Response `200`:

```json
{
  "data": {
    "name": "Weekend specials",
    "countLast30Days": 0,
    "lastSeenAt": "2030-03-14T09:30:00Z",
    "properties": [
      {
        "key": "key_example",
        "types": [
          "string"
        ],
        "samples": [
          "samples_example"
        ],
        "seenIn": 0
      }
    ],
    "usedBy": {
      "journeys": [
        {
          "id": "018f2a4e-6b1c-7d3e-9f40-37386ae05a6b",
          "name": "Weekend specials",
          "status": "draft"
        }
      ],
      "segments": [
        {
          "id": "018f2a4e-6b1c-7d3e-9f40-37386ae05a6b",
          "name": "Weekend specials"
        }
      ],
      "campaigns": [
        {
          "id": "018f2a4e-6b1c-7d3e-9f40-37386ae05a6b",
          "name": "Weekend specials",
          "status": "draft"
        }
      ],
      "conversionGoals": [
        {
          "id": "018f2a4e-6b1c-7d3e-9f40-37386ae05a6b",
          "campaignId": "018f2a4e-6b1c-7d3e-9f40-3478765e5a6b",
          "journeyId": "018f2a4e-6b1c-7d3e-9f40-7cf2bf7e5a6b"
        }
      ]
    }
  }
}
```