Skip to main content
GET
List received emails

Authorizations

Authorization
string
header
required

Paubox API uses Bearer token authentication in the Authorization header.

Format: Authorization: Bearer YOUR_API_KEY_HERE

Example: Authorization: Bearer 9e5b092b632445b8f570c62ae54f30fda1044305

The legacy format Authorization: Token token=YOUR_API_KEY_HERE is also supported.

Query Parameters

limit
integer
default:25

Maximum number of emails to return (1–100).

Required range: x <= 100
after
string

An email_id. Returns emails received before that email, which is the next (older) page when you pass the last email_id of the current page. An email_id that isn't found is ignored, and the first page is returned.

before
string

An email_id. Returns emails received after that email, newest first, up to limit. If more than limit newer emails exist, the response holds the newest of them, not the ones received just after the cursor. An email_id that isn't found is ignored, and the first page is returned.

Filter emails. Plain words match message text; from:, to: and subject: match those fields, for example from:sender@example.com subject:"monthly report".

Response

200 - application/json

Paginated list of received emails

object
string
Example:

"list"

data
object[]
has_more
boolean
Example:

false