Get Upcoming Scheduled Maintenances

GET /scheduled-maintenances/upcoming.json

Retrieves a list of upcoming scheduled maintenances (in the Scheduled state).

Responses

  • 200 application/json

    Upcoming scheduled maintenances retrieved successfully

    Hide response attributes Show response attributes object
    • page object Required
      Hide page attributes Show page attributes object
      • id string Required

        Unique identifier for the page

      • name string Required

        Name of the status page

      • url string(uri) Required

        URL of the status page

      • updated_at string(date-time) Required

        Timestamp when the page was last updated (ISO 8601)

    • scheduled_maintenances array[object] Required

      List of scheduled maintenances

      Hide scheduled_maintenances attributes Show scheduled_maintenances attributes object
      • created_at string(date-time) Required

        Timestamp when created (ISO 8601)

      • id string Required

        Unique maintenance identifier

      • impact string Required

        Impact level

        Values are none, minor, major, critical, or maintenance.

      • incident_updates array[object] Required

        List of updates

        Hide incident_updates attributes Show incident_updates attributes object
        • body string Required

          Update message

        • created_at string(date-time) Required

          Timestamp when the update was created (ISO 8601)

        • display_at string(date-time) | null Required

          Timestamp for display (ISO 8601)

        • id string Required

          Unique update identifier

        • incident_id string Required

          Unique incident identifier

        • status string Required

          Update status

          Values are investigating, identified, monitoring, resolved, postmortem, scheduled, in_progress, verifying, or completed.

        • updated_at string(date-time) Required

          Timestamp when the update was last modified (ISO 8601)

      • monitoring_at string(date-time) | null

        Timestamp when monitoring started (ISO 8601)

      • name string Required

        Maintenance name

      • page_id string Required

        Unique page identifier

      • postmortem_body string | null

        Postmortem body

      • postmortem_body_last_updated_at string(date-time) | null

        Timestamp when the postmortem was last updated (ISO 8601)

      • postmortem_ignored boolean

        Whether the postmortem is ignored

      • postmortem_notified_subscribers boolean

        Whether subscribers were notified of the postmortem

      • postmortem_published_at string(date-time) | null

        Timestamp when the postmortem was published (ISO 8601)

      • resolved_at string(date-time) | null

        Timestamp when the maintenance was resolved (ISO 8601)

      • scheduled_for string(date-time) Required

        Scheduled start (ISO 8601)

      • scheduled_remind_prior boolean

        Whether to send reminders prior to the scheduled maintenance

      • scheduled_reminded_at string(date-time) | null

        Timestamp when reminders were sent (ISO 8601)

      • scheduled_until string(date-time) Required

        Scheduled end time (ISO 8601)

      • status string Required

        Current maintenance status

        Values are scheduled, in_progress, verifying, or completed.

      • updated_at string(date-time) Required

        Timestamp when the maintenance was last updated (ISO 8601)

  • 404 application/json

    The requested resource was not found

    Hide response attributes Show response attributes object
    • message string Required

      Error message

    • code integer

      Error code

  • 500 application/json

    Internal server error

    Hide response attributes Show response attributes object
    • message string Required

      Error message

    • code integer

      Error code

GET /scheduled-maintenances/upcoming.json
curl \
 --request GET 'https://status.mongodb.com/api/v2/scheduled-maintenances/upcoming.json'
Response examples (200)
{
  "page": {
    "id": "y2j98763l56x",
    "name": "MongoDB Cloud Status",
    "url": "https://status.mongodb.com",
    "updated_at": "2025-03-11T00:52:20-07:00"
  },
  "scheduled_maintenances": [
    {
      "created_at": "2025-05-04T09:42:00Z",
      "id": "string",
      "impact": "none",
      "incident_updates": [
        {
          "body": "string",
          "created_at": "2025-05-04T09:42:00Z",
          "display_at": "2025-05-04T09:42:00Z",
          "id": "string",
          "incident_id": "string",
          "status": "investigating",
          "updated_at": "2025-05-04T09:42:00Z"
        }
      ],
      "monitoring_at": "2025-05-04T09:42:00Z",
      "name": "string",
      "page_id": "string",
      "postmortem_body": "string",
      "postmortem_body_last_updated_at": "2025-05-04T09:42:00Z",
      "postmortem_ignored": true,
      "postmortem_notified_subscribers": true,
      "postmortem_published_at": "2025-05-04T09:42:00Z",
      "resolved_at": "2025-05-04T09:42:00Z",
      "scheduled_for": "2025-05-04T09:42:00Z",
      "scheduled_remind_prior": true,
      "scheduled_reminded_at": "2025-05-04T09:42:00Z",
      "scheduled_until": "2025-05-04T09:42:00Z",
      "shortlink": "https://example.com",
      "status": "scheduled",
      "updated_at": "2025-05-04T09:42:00Z"
    }
  ]
}
Response examples (404)
{
  "code": 404,
  "message": "Resource not found"
}
Response examples (500)
{
  "code": 500,
  "message": "Internal server error"
}