# Events API

> Den Event-Stream hinter den Webhooks lesen: Zustellungen, Bounces, Öffnungen und mehr.

Basis-URL: `https://api.emailit.com/v2`. Authentifizieren Sie sich mit `Authorization: Bearer <API key>`.

## Events auflisten — GET /events

> Die Events in Ihrem Workspace auflisten, die neuesten zuerst, nach Typ und Datum. Events sind dieselben Datensätze, die Webhooks zustellen.

# Events auflisten

Gibt die Events in Ihrem Workspace zurück, die neuesten zuerst. Jede Webhook-Zustellung wird aus einem dieser Events erstellt. Mit diesem Endpunkt können Sie also Events nachholen, die Ihr Endpunkt verpasst hat. Erfordert einen API-Schlüssel mit dem Scope `full`.

`GET /events`

## Query-Parameter

- `page` (integer): Seitennummer, beginnend bei `1`. Standardwert `1`. Seiten jenseits von 2.500 Events (`(page - 1) × limit > 2500`) geben `422` zurück.

- `limit` (integer): Events pro Seite, von `1` bis `100`. Standardwert `100`.

- `type` (string): Event-Typ oder kommagetrennte Liste von Typen, zum Beispiel `email.delivered,email.bounced`. Siehe [Event-Typen](/de/docs/webhooks/event-types/).

- `include_data` (boolean): Setzen Sie den Wert auf `true`, um den Payload in `data` jedes Events einzuschließen. Standardwert `false`; dann werden nur `object`, `id`, `type` und `created_at` zurückgegeben.

- `match`, `order`, `direction`: siehe [Filtern und Sortieren](https://emailit.com/de/docs/api-reference/filtering/).

## Filter und Sortierung

Filter- und Sortierschlüssel: siehe [Filtern und Sortieren](https://emailit.com/de/docs/api-reference/filtering/).

Ohne Filter auf `created_at` umfasst die Liste nur die letzten 2 Tage. Um weiter zurückzublicken, fügen Sie einen hinzu, zum Beispiel `created_at.after=2026-09-01T00:00:00Z`. Ältere Events sind so lange verfügbar, wie die [Datenaufbewahrung](/de/docs/data-retention/) Ihres Tarifs sie speichert.

## Rückgabe

Gibt `200 OK` mit den Events in `data` sowie `next_page_url` und `previous_page_url` zurück (am jeweiligen Ende `null`). Die Seiten-URLs behalten `type`, `limit` und `include_data` bei.

Gibt `422` mit `code: "events_offset_too_large"` zurück, wenn die Seite zu tief liegt. Grenzen Sie den Zeitraum oder die Typen ein, statt weiterzublättern.

**Anfrage** `GET /events`

**Node.js**

```javascript
import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const events = await emailit.events.list({ type: 'email.delivered' });
```

**Python**

```python
from emailit import EmailitClient
client = EmailitClient("your_api_key")

events = client.events.list({"type": "email.delivered"})
```

**PHP**

```php
$emailit = Emailit::client('your_api_key');

$events = $emailit->events()->list(['type' => 'email.delivered']);
```

**Ruby**

```ruby
require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

events = client.events.list(type: "email.delivered")
```

**Go**

```go
import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

events, err := client.Events.List(&emailit.ListEventsRequest{Type: "email.delivered"})
```

**Rust**

```rust
use emailit::Emailit;
let emailit = Emailit::new("your_api_key");

let events = emailit.events.list(Some(emailit::types::ListEventsParams { r#type: Some("email.delivered".into()), ..Default::default() })).await?;
```

**Java**

```java
import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject events = emailit.events().list();
```

**.NET**

```csharp
using Emailit;

var emailit = new EmailitClient("your_api_key");

var events = emailit.Events.List(new EventListOptions { Type = "email.delivered" });
```

**Laravel**

```php
use Emailit\Laravel\Facades\Emailit;

$events = Emailit::events()->list(['type' => 'email.delivered']);
```

**cURL**

```bash
curl -X GET "https://api.emailit.com/v2/events?type=email.delivered" \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json"
```

**200**

```json
{
  "data": [
    {
      "object": "event",
      "id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
      "type": "email.delivered",
      "created_at": "2026-10-01T10:02:15.912000+00:00"
    }
  ],
  "next_page_url": "/v2/events?page=2&limit=100&type=email.delivered",
  "previous_page_url": null
}
```

**200 mit Daten**

```json
{
  "data": [
    {
      "object": "event",
      "id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
      "type": "email.delivered",
      "data": {
        "object": {
          "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
          "object": "email",
          "from": "hello@acme.com",
          "to": "ada@example.com",
          "subject": "Your order has shipped",
          "status": "delivered",
          "meta": { "order_id": "1042" },
          "updated_at": "2026-10-01T10:02:14.307000+00:00",
          "created_at": "2026-10-01T10:02:11.583000+00:00"
        }
      },
      "created_at": "2026-10-01T10:02:15.912000+00:00"
    }
  ],
  "next_page_url": "/v2/events?page=2&limit=100&type=email.delivered&include_data=true",
  "previous_page_url": null
}
```

**422**

```json
{
  "error": "Page is too deep. Narrow the type or date filter, or open an earlier page.",
  "code": "events_offset_too_large"
}
```

---
Quelle: https://emailit.com/de/docs/api-reference/events/list/

## Event abrufen — GET /events/{id}

> Ein Event per ID abrufen, mit dem vollständigen Daten-Payload, den Emailit an Ihre Webhooks gesendet hat oder senden würde.

# Event abrufen

Gibt ein Event mit seinem vollständigen Payload in `data` zurück. Die `id` ist derselbe Wert, den Webhooks als `event_id` senden. So können Sie jedes empfangene Event nachschlagen. Erfordert einen API-Schlüssel mit dem Scope `full`.

`GET /events/:id`

## Pfadparameter

- `id` (string, erforderlich): ID des Events, zum Beispiel `evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a`.

## Rückgabe

Gibt `200 OK` mit dem Event zurück: `object` (`event`), `id`, `type`, `data` und `created_at`. `data.object` hat dieselbe Form wie im Webhook-Payload für diesen Typ; siehe die [Referenz der Webhook-Events](/de/docs/webhooks/event-types/).

Gibt `404` mit `error: "Event not found"` zurück, wenn die ID in Ihrem Workspace nicht existiert.

**Anfrage** `GET /events/{id}`

**Node.js**

```javascript
import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const event = await emailit.events.get('evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a');
```

**Python**

```python
from emailit import EmailitClient
client = EmailitClient("your_api_key")

event = client.events.get("evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a")
```

**PHP**

```php
$emailit = Emailit::client('your_api_key');

$event = $emailit->events()->get('evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a');
```

**Ruby**

```ruby
require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

event = client.events.get("evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a")
```

**Go**

```go
import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

event, err := client.Events.Get("evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a")
```

**Rust**

```rust
use emailit::Emailit;
let emailit = Emailit::new("your_api_key");

let event = emailit.events.get("evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a").await?;
```

**Java**

```java
import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject event = emailit.events().get("evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a");
```

**.NET**

```csharp
using Emailit;

var emailit = new EmailitClient("your_api_key");

var ev = emailit.Events.Get("evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a");
```

**Laravel**

```php
use Emailit\Laravel\Facades\Emailit;

$event = Emailit::events()->get('evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a');
```

**cURL**

```bash
curl https://api.emailit.com/v2/events/evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a \
  -H "Authorization: Bearer your_api_key"
```

**200**

```json
{
  "object": "event",
  "id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.delivered",
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "delivered",
      "meta": { "order_id": "1042" },
      "updated_at": "2026-10-01T10:02:14.307000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  },
  "created_at": "2026-10-01T10:02:15.912000+00:00"
}
```

**404**

```json
{
  "error": "Event not found"
}
```

---
Quelle: https://emailit.com/de/docs/api-reference/events/get/