MailMate Releases
API Documentation
JSON API for querying MailMate releases, managing downloads, and email subscriptions.
Base URL
Response
{
  "endpoints": [
    {
      "name": "Releases",
      "desc": "Overview of all releases",
      "url": "https://mailmate.pulli.dev/api/releases"
    },
    {
      "name": "Latest release",
      "desc": "Returns the latest release",
      "url": "https://mailmate.pulli.dev/api/latest"
    },
    {
      "name": "Download",
      "desc": "Download a release by filename",
      "url": "https://mailmate.pulli.dev/api/download/{name}"
    },
    {
      "name": "Subscribe",
      "desc": "Subscribe to release notifications",
      "url": "https://mailmate.pulli.dev/api/subscribe"
    }
  ]
}
Parameters
Parameter
Type
Default
Description
page
integer
1 Page number
limit
integer
250 Results per page (250, 500, or 1000)
Response
{
  "data": [
    {
      "name": "MailMate_r6292.tbz",
      "version": 6292,
      "human_size": "16.78 MB",
      "byte_size": 17596416,
      "original_download_url": "https://updates.mailmate-app.com/...",
      "mirror_download_url": "https://s3.../...",
      "date": "2025-10-12T04:41:00.000000Z",
      "hashes": {
        "sha1": "abc123...",
        "sha256": "def456...",
        "sha512": "ghi789..."
      }
    }
  ],
  "links": { "first": "...", "last": "...", "prev": null, "next": "..." },
  "meta": { "current_page": 1, "last_page": 2, "per_page": 250, "total": 309 }
}
Response
{
  "data": {
    "name": "MailMate_r6292.tbz",
    "version": 6292,
    "human_size": "16.78 MB",
    "byte_size": 17596416,
    "original_download_url": "https://updates.mailmate-app.com/...",
    "mirror_download_url": "https://s3.../...",
    "date": "2025-10-12T04:41:00.000000Z",
    "hashes": {
      "sha1": "abc123...",
      "sha256": "def456...",
      "sha512": "ghi789..."
    }
  }
}
Parameters
Parameter
Type
Description
name
string
Release filename (e.g. MailMate_r6292.tbz)
Parameters
Parameter
Type
Required
Description
email
string
Yes
Subscriber email address (must be unique)
name
string
No
Subscriber name (max 255 characters)
Response (201)
{
  "message": "You subscribed successfully. You get notified as soon as a new MailMate release is published."
}