API Reference

List Received Emails

GET /emails/receiving — list the emails received by your domains.

GET/emails/receiving

List the emails received by your domains. The list returns a reference to each received email; use an email's id to fetch its full content with GET /emails/receiving/:id, or its attachments.

This endpoint returns only emails received by your domains. To list emails your account has sent, use GET /emails.

This endpoint is paginated. The limit parameter is optional — if you omit it, all received emails are returned in a single response. See Pagination.

Query parameters

limitnumberoptional

Number of received emails to retrieve per page. Optional. Maximum 100, minimum 1.

afterstringoptional

The email id after which more emails are retrieved. The passed id is not included. Cannot be combined with before.

beforestringoptional

The email id before which more emails are retrieved. The passed id is not included. Cannot be combined with after.

Request

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

const { data, error } = await mb.emails.receiving.list();
console.log({ data, error });

Response

A paginated list object. Each item in data is a received-email reference with its addressing, subject, message_id, and an attachments summary.

{
  "object": "list",
  "has_more": true,
  "data": [
    {
      "object": "received_email",
      "id": "a39999a6-88e3-48b1-888b-beaabcde1b33",
      "to": ["recipient@yourdomain.com"],
      "from": "sender@example.com",
      "created_at": "2026-06-23T14:37:40.951Z",
      "subject": "Hello World",
      "message_id": "<111-222-333@email.example.com>",
      "raw_available": false,
      "attachments": [
        {
          "id": "47e999c7-c89c-4999-bf32-aaaaa1c3ff21",
          "filename": "example.txt",
          "content_type": "text/plain",
          "content_disposition": "attachment",
          "size": 13,
          "downloadable": false
        }
      ]
    }
  ]
}

Errors

Returns validation_error if limit is outside 1–100, if a cursor is malformed, or if both before and after are supplied. See the error reference.