> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taap.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Événements personnalisés

> Événements personnalisés les plus fréquents du projet

Renvoie les événements personnalisés les plus fréquents du projet lié à votre clé API, classés
par volume.

**Requête :**

```bash cURL theme={null}
curl -X GET 'https://taap.it/api/v1/radar/custom-events?start=2026-01-01T00:00:00Z&end=2026-01-31T23:59:59Z&limit=20' \
  -H 'Authorization: Bearer taapit_votre_cle_api_ici'
```

**Réponse :**

```json theme={null}
{
  "data": [
    { "event_name": "signup_click", "people": 240, "events": 312, "completion_rate": 0 },
    { "event_name": "add_to_cart", "people": 180, "events": 410, "completion_rate": 0 }
  ],
  "limit": 20
}
```

## Autorisation

<ParamField header="Authorization" type="string" required>
  Jeton Bearer avec votre clé API Radar. Format : `Bearer taapit_...`
</ParamField>

## Paramètres de requête

<ParamField query="start" type="string">
  Début de la plage, ISO 8601 (UTC). Optionnel — omettre pour toute la période.
</ParamField>

<ParamField query="end" type="string">
  Fin de la plage, ISO 8601 (UTC). Optionnel — omettre pour toute la période.
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Nombre maximal d'événements à renvoyer. Plafonné à `500`.
</ParamField>

## Champs de réponse

<ResponseField name="data" type="array" required>
  Événements personnalisés classés par volume.

  <Expandable title="Événement" defaultOpen>
    <ResponseField name="event_name" type="string">Nom de l'événement personnalisé.</ResponseField>
    <ResponseField name="people" type="number">Nombre de personnes uniques l'ayant déclenché.</ResponseField>
    <ResponseField name="events" type="number">Nombre total de déclenchements.</ResponseField>
    <ResponseField name="completion_rate" type="number">Réservé aux tunnels ; vaut `0` actuellement.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="limit" type="integer">
  La limite effective appliquée à cette réponse.
</ResponseField>