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, up to 1,000 received emails are returned in a single response. Always check has_more and keep paging with after if it is true. 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.

received_forstringoptional

Return only mail delivered to that address. Matched case-insensitively against the envelope recipient list, so it finds mail addressed via bcc or an alias too.

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 or if both before and after are supplied. A malformed or unknown cursor is not an error — it returns an empty page (data: [], has_more: false). See the error reference.