Introduction

This is a guide to help you to integrate with Maily Space, We provided RESTful API which can be access via HTTP requests

RESTful Endpoint https://api.maily.space/v1/[PATHS]

Get Token

Token is required for all API requests, you can obtain a token by visiting this dashboard page

https://maily.space/dashboard/api

Get Mails

To get all email with filters, you can send a request to the following endpoint

Request

POST: https://api.maily.space/v1/mails

{
  "apiKey": "sk_v1_zo..."
  //
  "email": "[email protected]",
  "size": 40, // optional
  "page": 1, // optional
  "search": "test subject", // optional
}

Default sort is createdAt descending from newest to oldest
Maximum size for each request is 1000
search field will search for from, to and subject fields

Response

totalPage: 10,
currentPage: 1,
mails: [
  {
    "id": "a57p9v7hjlhrurxtks1b9t46"
    "from": "[email protected]",
    "to": "[email protected]",
    "subject": "Verify your email address",
    "html": "<!doctypehtml><html style=background...",
    "text": "Tap the link to create your acco..",
    "createdAt": "2026-05-04T14:01:42.007Z" // UTC time
  }
]