List Events

Retrieve a list of events in your workspace. Requires full permission. Events are read-only — they are created automatically when actions occur across the API.

GET/events

Query Parameters

pageinteger

Page number for pagination (minimum: 1, default: 1).

limitinteger

Number of events to return (minimum: 1, maximum: 100, default: 100).

typestring

Filter by event type. Supports comma-separated values (e.g. email.accepted,email.delivered).

include_databoolean

Include the full event data payload (default: false). Omitted by default for lighter responses.

GET /events

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

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

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

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

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

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

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

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

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

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

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?;

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

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

using Emailit;

var emailit = new EmailitClient("your_api_key");

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

use Emailit\Laravel\Facades\Emailit;

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

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

{
  "data": [
    {
      "object": "event",
      "id": "evt_2BxFg7KNqr5M...",
      "type": "email.accepted",
      "created_at": "2026-02-10T10:00:00.000000+00:00"
    }
  ],
  "next_page_url": "/v2/events?page=2&limit=100",
  "previous_page_url": null
}

{
  "data": [
    {
      "object": "event",
      "id": "evt_2BxFg7KNqr5M...",
      "type": "email.accepted",
      "data": {
        "object": {
          "id": "em_xxx",
          "object": "email",
          "from": "sender@example.com",
          "to": "recipient@example.com",
          "subject": "Hello",
          "timestamp": "2026-02-10T10:00:00.000000+00:00"
        }
      },
      "created_at": "2026-02-10T10:00:00.000000+00:00"
    }
  ],
  "next_page_url": null,
  "previous_page_url": null
}

{
  "error": {
    "code": 401,
    "message": "Unauthorized"
  }
}

Get Event

Retrieve information about a specific event. Requires full permission. Always includes the full data payload. Events are identified by ID (evt_xxx).

GET/events/{id}

Path Parameters

idstringRequired

The event ID (evt_xxx).

GET /events/{id}

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

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

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

event = client.events.get("evt_123")

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

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

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

event = client.events.get("evt_123")

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

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

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

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

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject event = emailit.events().get("evt_123");

using Emailit;

var emailit = new EmailitClient("your_api_key");

var evt = emailit.Events.Get("evt_123");

use Emailit\Laravel\Facades\Emailit;

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

curl -X GET https://api.emailit.com/v2/events/evt_123 \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json"

{
  "object": "event",
  "id": "evt_2BxFg7KNqr5M...",
  "type": "email.accepted",
  "data": {
    "object": {
      "id": "em_xxx",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Hello",
      "timestamp": "2026-02-10T10:00:00.000000+00:00"
    }
  },
  "created_at": "2026-02-10T10:00:00.000000+00:00"
}

{
  "error": "Event not found"
}