Skip to main content

​
GET /inbound

Returns a paginated list of inbound emails for the authenticated user.

​
Authentication

Bearer token (JWT or API key)

​
Query Parameters

ParameterTypeRequiredDescription
domain_idstringNoFilter by domain
pagenumberNoPage number (default: 1)
limitnumberNoResults per page (default: 20, max: 100)

​
Response

{
  "data": {
    "emails": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "domain_id": "...",
        "from_email": "sender@example.com",
        "from_name": "Sender Name",
        "to_emails": ["hello@in.yourdomain.com"],
        "cc_emails": [],
        "subject": "Hello!",
        "spam_verdict": "PASS",
        "virus_verdict": "PASS",
        "spf_verdict": "PASS",
        "dkim_verdict": "PASS",
        "dmarc_verdict": "PASS",
        "status": "received",
        "created_at": "2026-03-07T12:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "totalPages": 1
    }
  }
}