# Email History Endpoints {#email-history-endpoints}


Query email delivery history and status.


## Base Path {#base-path}


```
/api/email-history
```


## Endpoints {#endpoints}



### List Email History {#list-email-history}


```
GET /api/email-history
Authorization: Bearer {token}
```

**Query Parameters:**

| Parameter | Type   | Description          |
| --------- | ------ | -------------------- |
| `page`    | number | Page number          |
| `limit`   | number | Items per page       |
| `email`   | string | Recipient email      |
| `status`  | string | SENT, FAILED, QUEUED |

**Response:**

```json
{
  "items": [
    {
      "id": "uuid",
      "name": "WELCOME_USER",
      "email": "john@example.com",
      "content": "Welcome to Gauzy...",
      "status": "SENT",
      "createdAt": "2025-01-15T10:00:00Z"
    }
  ],
  "total": 500
}
```


### Get Email by ID {#get-email-by-id}


```
GET /api/email-history/:id
Authorization: Bearer {token}
```


### Resend Email {#resend-email}


```
POST /api/email-history/:id/resend
Authorization: Bearer {token}
```


### Delete Email History {#delete-email-history}


```
DELETE /api/email-history/:id
Authorization: Bearer {token}
```


## Email Types {#email-types}


| Type                  | Description            |
| --------------------- | ---------------------- |
| `WELCOME_USER`        | New user welcome       |
| `INVITE_EMPLOYEE`     | Employee invitation    |
| `INVOICE_SENT`        | Invoice delivery       |
| `PASSWORD_RESET`      | Password reset link    |
| `TIMESHEET_SUBMITTED` | Timesheet notification |
| `TASK_ASSIGNED`       | Task assignment        |


## Related Pages {#related-pages}


- [Email Template Endpoints](https://sourcey-gauzy.pages.dev/api/email-template-endpoints/index.md) — templates
- [Email Delivery Issues](https://sourcey-gauzy.pages.dev/troubleshooting/email-delivery/index.md) — troubleshooting
- [Custom SMTP](https://sourcey-gauzy.pages.dev/features/custom-smtp/index.md) — SMTP configuration