API reference

Test inbox

Every email sent with a test key (sk_test_…) lands here instead of a real inbox, rendered exactly as it would be sent. Use it to check templates and flows end to end.

The TestInboxEntry object

type TestInboxEntry = {
  id: string; message_id: string;
  to: string; subject: string;
  type: "transactional" | "marketing";
  template: string | null;
  html: string;
  created_at: string;
};

Read the test inbox

GET/v1/test-inbox

Emails sent with test keys, newest first, with their rendered HTML.

Query parameters

limitinteger
How many to return, 1–100. Default 50.
cursorstring
The next_cursor from the previous page.

curl https://api.mailpark.io/v1/test-inbox \
  -H "Authorization: Bearer $MAILPARK_API_KEY"

Response · 200

{
  "data": [
    {
      "id": "tin_6Wm3",
      "message_id": "msg_01JB4Q7Z2K",
      "to": "jane@example.com",
      "subject": "Reset your Acme password",
      "type": "transactional",
      "template": "password-reset",
      "html": "<!doctype html><html>…</html>",
      "created_at": "2026-10-22T10:02:11Z"
    }
  ],
  "next_cursor": null
}

▶ Try it in the playground