If you would like to check Postmark’s status from your own applications, we provide a basic JSON API. HTTP requests should be sent to https://status.postmarkapp.com/api/1.0.

You can also use Postmark’s Slack app to get information about Postmark’s current status. Install it from the Slack app directory.

Services status

GET /services– Get the current status of Postmark’s services. Statuses can be UPMAINTENANCEDELAYDEGRADEDDOWN.

[
    {
        "name": "API",
        "status": "DOWN",
        "url": "/services/api"
    },
    {
        "name": "Outbound SMTP",
        "status": "MAINTENANCE",
        "url": "/services/smtp"
    },
    {
        "name": "Web App",
        "status": "UP",
        "url": "/services/web"
    },
    {
        "name": "Inbound SMTP",
        "status": "DELAY",
        "url": "/services/inbound"
    }
]

Current status

GET /status– Get the current system status. Statuses can be UPMAINTENANCEDELAYDEGRADEDDOWN.

{
    "status": "UP",
    "lastCheckDate": "2016-03-17T14:50:24+00:00"
}

Incidents

Last Incident

GET /last_incident– Get last recorded incident.

{
    "id": "17",
    "type": "MAINTENANCE",
    "created_at": "2016-03-03T20:54:00+00:00",
    "updated_at": "2016-03-11T00:38:43+00:00",
    "resolved_at": "2016-03-04T18:17:10+00:00",
    "title": "All sending has been cancelled today",
    "services": [
      "Outbound SMTP",
      "Inbound SMTP"
    ],
    "body": "<p>Body of the incident</p>",
    "updates": [
        {
            "body": "All sending has been cancelled today",
            "status": "Investigating",
            "timestamp": "2016-03-03T20:54:36+00:00"
        },
        {
            "body": "Sending is now enabled again.",
            "status": "Resolved",
            "timestamp": "2016-03-04T18:17:10+00:00"
        }
    ]
}

List of Incidents

GET /incidents– Get a list of all current and past incidents.

[{
    "id": "17",
    "type": "MAINTENANCE",
    "created_at": "2016-03-03T20:54:00+00:00",
    "updated_at": "2016-03-11T00:38:43+00:00",
    "resolved_at": "2016-03-04T18:17:10+00:00",
    "title": "All sending has been cancelled today",
    "services": [
      "Outbound SMTP",
      "Inbound SMTP"
    ],
    "body": "<p>Body of the incident</p>",
    "updates": [
        {
            "body": "All sending has been cancelled today",
            "status": "Investigating",
            "timestamp": "2016-03-03T20:54:36+00:00"
        },
        {
            "body": "Sending is now enabled again.",
            "status": "Resolved",
            "timestamp": "2016-03-04T18:17:10+00:00"
        }
    ]
}, ...]

Single Incident

GET /incidents/:id– Get single incident by ID.

{
    "id": "17",
    "type": "MAINTENANCE",
    "created_at": "2016-03-03T20:54:00+00:00",
    "updated_at": "2016-03-11T00:38:43+00:00",
    "resolved_at": "2016-03-04T18:17:10+00:00",
    "title": "All sending has been cancelled today",
    "services": [
      "Outbound SMTP",
      "Inbound SMTP"
    ],
    "body": "<p>Body of the incident</p>",
    "updates": [
        {
            "body": "All sending has been cancelled today",
            "status": "Investigating",
            "timestamp": "2016-03-03T20:54:36+00:00"
        },
        {
            "body": "Sending is now enabled again.",
            "status": "Resolved",
            "timestamp": "2016-03-04T18:17:10+00:00"
        }
    ]
}

System Availability

GET /services/availability-by-service– Get the uptime/dowtime and uptime percentage of each Postmark service

{
    "fromDate": "2018-12-27T16:05:28.701Z",
    "toDate": "2019-03-27T16:05:28.702Z",
    "services": [
        {
            "name": "API",
            "availability": {
                "secondsUp": 8078515,
                "secondsDown": 180,
                "percentageUp": 0.9999779546171299
            }
        },
        {
            "name": "Outbound SMTP",
            "availability": {
                "secondsUp": 8078204,
                "secondsDown": 480,
                "percentageUp": 0.9999412122331464
            }
        },
        {
            "name": "Web App",
            "availability": {
                "secondsUp": 8078695,
                "secondsDown": 0,
                "percentageUp": 1
            }
        },
        {
            "name": "Inbound SMTP",
            "availability": {
                "secondsUp": 8078669,
                "secondsDown": 0,
                "percentageUp": 1
            }
        }
    ]
}

GET /services/availability– Get the uptime/dowtime and uptime percentage of every Postmark service combined.

{
    "fromDate": "2015-12-18T15:56:19.850Z",
    "toDate": "2016-03-17T15:56:19.853Z",
    "secondsUp": 24936056,
    "secondsDown": 464484,
    "percentageUp": 0.9817136171120772
}