List Emails

Retrieve a list of outbound emails.

Endpoint: GET https://api.litestartup.com/client/v2/emails

Headers

Header	Required	Description
Authorization	Yes	Bearer token with your API key: `Bearer sk_live_xxxxxxxxxxxxx`

Query Parameters

Parameter	Type	Required	Description
page	integer	No	Page number (default: 1)
limit	integer	No	Number of results per page (default: 20, max: 100)
status	string	No	Filter by status: `sent`, `draft`, `failed`

Example

curl -X GET "https://api.litestartup.com/client/v2/emails?page=1&limit=20" \
     -H 'Authorization: Bearer sk_live_xxxxxxxxxxxxx'

Response (Success)

{
  "code": 200,
  "message": "Success",
  "data": {
    "emails": [
      {
        "id": 12345,
        "message_id": "[email protected]",
        "from_email": "[email protected]",
        "to_email": "[email protected]",
        "subject": "Welcome!",
        "status": "sent",
        "created_at": "2026-01-23 10:30:00"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 100,
      "total_pages": 5
    }
  }
}

Error Codes

Code	Description
200	Emails retrieved successfully
401	Invalid or missing API key
500	Server error