---
title: "Emails"
description: "Every email Filemonk sent and how far it got."
url: https://docs.filemonk.io/v2/api-reference/emails/
api: "API v2 reference"
---

# Emails

Every email Filemonk sent and how far it got.

## The email object

- `id` (string, nullable, required): e.g. `77c81a2e-4221-4a03-b784-221de4b1bf5c`
- `kind` (string, nullable, required): e.g. `delivery`
- `to` (string, nullable, required): e.g. `shopper@example.com`
- `from` (string, nullable, required): e.g. `alerts@example-store.filemonk.io`
- `order` (object, required)
  - `id` (string, nullable, required): e.g. `3e84eb8d-e1d9-4e92-a4b2-a419c7f1122f`
  - `name` (string, nullable, required): e.g. `#1077`
- `status` (string, nullable, required): e.g. `delivered`
- `timeline` (object, required)
  - `sent_at` (string, nullable, required): e.g. `2026-10-30T23:02:25Z`
  - `delivered_at` (string, nullable, required): e.g. `2026-10-30T23:02:24Z`
  - `opened_at` (any, required)
  - `clicked_at` (any, required)
  - `bounced_at` (any, required)
  - `rejected_at` (any, required)
  - `complained_at` (any, required)
- `created_at` (string, nullable, required): e.g. `2026-10-30T23:02:24Z`

```json
{
  "id": "77c81a2e-4221-4a03-b784-221de4b1bf5c",
  "kind": "delivery",
  "to": "shopper@example.com",
  "from": "alerts@example-store.filemonk.io",
  "order": {
    "id": "3e84eb8d-e1d9-4e92-a4b2-a419c7f1122f",
    "name": "#1077"
  },
  "status": "delivered",
  "timeline": {
    "sent_at": "2026-10-30T23:02:25Z",
    "delivered_at": "2026-10-30T23:02:24Z",
    "opened_at": null,
    "clicked_at": null,
    "bounced_at": null,
    "rejected_at": null,
    "complained_at": null
  },
  "created_at": "2026-10-30T23:02:24Z"
}
```

## Endpoints

- `GET /emails`: [List emails](https://docs.filemonk.io/v2/api-reference/emails/list-emails.md)