> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lifygo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Email Logs

> GET /logs — View email delivery history

# Email Logs

`GET /logs`

Returns a paginated history of emails sent using your API key.

Each log contains recipient information, delivery status, timestamps, and any SMTP errors.

***

## Endpoint

```http theme={null}
GET /logs
```

***

## Request

```bash theme={null}
curl "http://localhost:8080/logs?limit=10&offset=0" \
  -H "X-API-Key: lfy_your_key"
```

***

## Query Parameters

| Parameter | Type     | Default | Description                  |
| --------- | -------- | ------: | ---------------------------- |
| `limit`   | `int`    |    `10` | Number of results per page   |
| `offset`  | `int`    |     `0` | Pagination offset            |
| `status`  | `string` |       — | Filter by `sent` or `failed` |

***

## Successful Response

```json theme={null}
{
  "logs": [
    {
      "id": "log_abc123",
      "to": "hello@example.com",
      "subject": "Welcome",
      "status": "sent",
      "error_message": null,
      "sent_at": "2026-07-22T09:00:00Z"
    }
  ],
  "total": 1,
  "limit": 10,
  "offset": 0
}
```

***

## Log Statuses

| Status   | Description                                                |
| -------- | ---------------------------------------------------------- |
| `sent`   | Email was successfully delivered to the SMTP server        |
| `failed` | Sending failed. Check `error_message` for more information |