Skip to main content
GET
/
emails
List Sent Emails
curl --request GET \
  --url https://api.unosend.co/emails \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "id": "<string>",
      "from": "<string>",
      "to": [
        "<string>"
      ],
      "subject": "<string>",
      "status": "<string>",
      "created_at": "<string>"
    }
  ],
  "meta": {
    "total": 123,
    "page": 123,
    "page_size": 123,
    "pages": 123
  }
}
​
page
integer
default:"1"
Page number.
​
per_page
integer
default:"50"
Number of emails per page (max 100).
​
status
string
Filter by status: queued, sent, delivered, bounced, complained.

​
Request

curl "https://api.unosend.co/emails?page=1&per_page=10" \
  -H "Authorization: Bearer un_xxxxxxxxxx"

​
Response

200
{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "from": "hello@yourdomain.com",
      "to": ["user@example.com"],
      "subject": "Hello World",
      "status": "delivered",
      "created_at": "2024-01-15T10:30:00.000Z"
    }
  ],
  "meta": {
    "total": 42,
    "page": 1,
    "page_size": 10,
    "pages": 5
  }
}
​
success
boolean
Whether the request was successful.
​
data
array
Array of email objects.
​
meta
object
Pagination metadata.