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."
}

Back to Releases