Get Upcoming Batch Details

Purpose

To fetch details of the upcoming batches of a scheduled maintenance.

Request URL

https://fsm.zoho.com/fsm/v1/Scheduled_Maintenances/<record_id>/upcoming

<record_id> - The unique ID of the record.

Request Method

GET

Scope

scope=ZohoFSM.modules.ScheduledMaintenances.READ

Parameters

Name	Data Type	Description
no_of_batches	Number	The no of upcoming batches whose details you want to fetch

Sample Request

Copiedcurl --request GET 'https://fsm.zoho.com/fsm/v1/Scheduled_Maintenances/1439XXXX0021/upcoming?no_of_batches=5' \
--header 'Authorization: Zoho-oauthtoken 1000.3xxxxxxxxx.xxxxxxxxxxxxx0e'

Sample Response

Copied{
    "upcoming_data": {
        "upcoming_events": [
            {
                "generation_date": "2026-07-30",
                "recurring_dates": [
                    "2026-07-30"
                ]
            },
            {
                "generation_date": "2026-07-31",
                "recurring_dates": [
                    "2026-07-31"
                ]
            },
            {
                "generation_date": "2026-08-01",
                "recurring_dates": [
                    "2026-08-01"
                ]
            },
            {
                "generation_date": "2026-08-02",
                "recurring_dates": [
                    "2026-08-02"
                ]
            },
            {
                "generation_date": "2026-08-03",
                "recurring_dates": [
                    "2026-08-03"
                ]
            }
        ],
        "is_work_order_template_present": true,
        "is_appointment_template_present": false
    }
}