Skip to main content
GET
/
v1
/
emails
List Sent Emails
curl --request GET \
  --url https://api.example.com/v1/emails
{
  "data": [
    {
      "id": "<string>",
      "from": "<string>",
      "to": [
        "<string>"
      ],
      "subject": "<string>",
      "status": "<string>",
      "created_at": "<string>"
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}
​
limit
integer
default:"20"
Number of emails to return (max 100).
​
offset
integer
default:"0"
Number of emails to skip.
​
status
string
Filter by status: queued, sent, delivered, bounced, complained.

​
Request

curl "https://api.unosend.co/emails?limit=10&offset=0" \
  -H "Authorization: Bearer un_xxxxxxxxxx"

​
Response

200
{
  "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"
    }
  ],
  "total": 42,
  "limit": 10,
  "offset": 0
}
​
data
array
Array of email objects.
​
total
integer
Total number of emails matching the query.
​
limit
integer
Number of results per page.
​
offset
integer
Number of results skipped.