BitelioBitelio

List emails

The project's send history, newest first, cursor-paginated. Shows live sends only by default; use mode to see test sends.

There is deliberately no search by subject or body: over millions of rows that is a scan, and saying so is better than offering it and being slow.

The rendered body is not in the listing — that is hundreds of kilobytes a page. It is on GET /v1/emails/{id}.

GET
/v1/emails

Authorization

ApiKeyAuth

AuthorizationBearer <token>

API Key authentication. Secret keys (sk_*) are required for all endpoints except /v1/track. Public keys (pk_*) only work with the /v1/track endpoint for client-side event tracking. The project is automatically derived from the key.

In: header

Query Parameters

limit?integer

Page size.

Default25
Range1 <= value <= 100
cursor?string

The previous page's nextCursor. Opaque — return it verbatim.

mode?string

Which sends to show.

Default"live"
Value in"live" | "test" | "all"
status?string

Filter by delivery status.

Value in"PENDING" | "SENDING" | "HELD" | "SENT" | "DELIVERED" | "RECEIVED" | "OPENED" | "CLICKED" | "BOUNCED" | "COMPLAINED" | "FAILED"
to?string

Recipient address. Empty if they are not a contact of this project.

Formatemail
since?string

ISO 8601.

Formatdate-time
until?string

ISO 8601.

Formatdate-time

Response Body

application/json

curl -X GET "https://api.bitelio.com/v1/emails"
{
  "data": [
    {}
  ],
  "nextCursor": "string"
}
Empty
Empty