---
title: "Get email events"
method: GET
path: "/v4/email/outgoing/events"
tags: ["Email - Outgoing"]
---

# Get email events

`GET /v4/email/outgoing/events`

## Request

- Base URL: `https://api.inmobile.com`
- URL: `https://api.inmobile.com/v4/email/outgoing/events`
- Auth: one of:
  - HTTP basic
  - API key in query parameter `apikey`

Each event will only be returned once. Once called, the event has been removed from our side and cannot be retrieved again using this method.

## Query parameters

- `limit` integer

## Response `200`

A list of email events

- EmailEventListModel
  - `events` EmailEvent[]
    - `messageId` string: The id of the message.
    - `eventType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9: 0 = Undefined 1 = Clicked 2 = Complained 3 = Delivered 4 = Opened 5 = PermanentFail 6 = TemporaryFail 7 = Unsubscribed 8 = Queued 9 = Attempt
    - `eventTypeDescription` string: A text description of the event type.
    - `eventTimestamp` string: When the event happened e.g. 2001-02-30T14:50:23Z (UTC time).

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `500`: Internal server error

---

[API](https://skmtc.dev/inmobile/apis/inmobile-rest-api.md) · [All operations](https://skmtc.dev/inmobile/apis/inmobile-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inmobile/apis/inmobile-rest-api/revisions/197a90ad5f8f?raw)