Welcome to the New BigPanda API Documentation

Retrieve a Plan

US Region

https://api.bigpanda.io

GET

/resources/v2.0/maintenance-plans/{maintenance_id}

Retrieves the schema definition for a specific maintenance plan.

Retrieval limits

Maintenance plans can only be returned for 60 days after the end date.
The API can only return up to 100,000 maintenance plans.

Authentication

All BigPanda APIs require Bearer Token Authorization in the call headers.
This API uses the User API Key type of Authorization token. Your User API Key must be provided in the header, prefixed by the word Bearer.

Example:
Authorization: Bearer [YOUR_USER_API_KEY]

Rate limit: 5 requests per second.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200

application/json

200

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.bigpanda.io/resources/v2.0/maintenance-plans/' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "id": "64f0b24f340000bbd269595c",
    "status": "planned",
    "maintenance_key": "MNT-de9d22d700e9",
    "name": "host1 maintenance",
    "start": 1733904622,
    "end": 1734768622,
    "description": "this is a description",
    "custom_tags": [
        {
            "name": "app",
            "value": "esp"
        }
    ],
    "created_by": "63bd56897755560012bf3555",
    "created_at": 1613252381,
    "updated_by": "63bd56897755560012bf3555",
    "updated_at": 1613252381,
    "frequency": "Daily",
    "frequency_data": 1613252381
}

Modified at 2026-09-04 16:33:42

Retrieve All Plans

Stop Plan

Retrieve a Plan

Retrieval limits#

Authentication#

Request

Responses

Retrieval limits

Authentication