# GET /email/logs

**Resource:** [Email](./email.md)  
**Scopes:** `email:read`  
**Write operation:** no

List email send logs. Each log includes subject, recipient_email, sender_email, status, provider, cc, thread_id, and sender_user_id. Filter by status, contact, deal, type, or provider.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `status` | query | string | no | Filter by status (sent, delivered, bounced, failed, spam_complaint) |
| `contact_id` | query | uuid | no | Filter by contact UUID |
| `deal_id` | query | uuid | no | Filter by deal UUID |
| `email_type` | query | string | no | Filter by type (e.g. form_submission, automation, manual) |
| `provider` | query | string | no | Filter by provider: "postmark" or "gmail" |

## Response example

```json
{
  "data": [
    {
      "id": "log-uuid-...",
      "subject": "Welcome to TrustPager",
      "recipient_email": "client@example.com",
      "recipient_name": "Jane Doe",
      "sender_email": "team@company.com",
      "sender_name": "Acme Corp",
      "sender_user_id": null,
      "email_type": "automation",
      "status": "delivered",
      "provider": "postmark",
      "cc": null,
      "thread_id": null,
      "contact_id": "contact-uuid-...",
      "customer_id": null,
      "deal_id": null,
      "created_at": "2026-04-14T10:00:00Z"
    }
  ],
  "pagination": { "limit": 25, "has_more": false, "next_cursor": null }
}
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`