---
title: "List Events"
method: GET
path: "/api/events"
tags: ["events"]
---

# List Events

`GET /api/events`

## Request

- Base URL: `https://outsend.xyz`
- URL: `https://outsend.xyz/api/events`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Événements du compte.

Usage type d'un connecteur : mémoriser `head_id` à l'activation, puis
repasser en `?since_id=<last_id>` — chaque événement n'est vu qu'une fois.

Trois champs de sortie, à ne pas confondre :
  - `last_id` : id du DERNIER événement de CETTE page. C'est le curseur de
    rattrapage, et lui seul.
  - `head_id` : id du PLUS RÉCENT événement du compte pour ce filtre, quelle
    que soit la page. C'est ce qu'il faut mémoriser quand on veut démarrer
    « à partir de maintenant » sans rejouer l'historique. Sans ce champ, un
    client qui appelait `?limit=1` pour trouver la tête récupérait en fait
    l'événement le PLUS ANCIEN (l'ordre est croissant) et repartait donc de
    zéro au polling suivant — c'est exactement le piège dans lequel étaient
    tombés les triggers Zapier et Make.
  - `order=desc` : renvoie les plus récents d'abord, pour peupler les
    exemples d'un éditeur de scénario avec des données représentatives
    plutôt qu'avec les premiers jobs jamais lancés.

## Query parameters

- `since_id` integer: Ne renvoyer que les événements d'id strictement supérieur
- `types` string, nullable: Filtre CSV, ex: job.completed,pipeline.completed
- `limit` integer
- `order` string: asc = chronologique (rattrapage) ; desc = les plus récents d'abord (chargement d'exemples)

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/outsend/apis/outsend-api.md) · [All operations](https://skmtc.dev/outsend/apis/outsend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/outsend/apis/outsend-api/revisions/39db3c6f886a?raw)