---
updatedAt: 2026-04-28T05:46:18.000Z
agentTools:
  projectIndex: https://developers.intandem.tech/llms.txt
---

# Get Next Execution Time

## Overview
Retrieves the next scheduled execution time for a specific automation flow rule. This endpoint is useful for displaying when an automation will next run, allowing users to see upcoming execution times.

## Use Cases
- Display the next execution time for an automation flow
- Show users when their scheduled automation will next run
- Calculate and display countdown timers for upcoming executions
- Validate that a flow has future executions scheduled

## Response
Returns the next execution time slot in the flow's configured timezone. The time is returned in a format that can be parsed and displayed to users.

Available for **Staff and Directory tokens**.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Platform_administration",
    "description": "Unified OpenAPI specification for platform_administration domain",
    "version": "3.0",
    "x-generated": {
      "sourceFiles": [
        "license.json",
        "operator-portal.json",
        "directory.json",
        "legacy_v2_todo.json",
        "legacy_v1_platform.json",
        "legacy_v2_settings_businesses.json",
        "business.json",
        "staff.json",
        "staff_member.json",
        "oauth.json",
        "online_profiles.json",
        "partners-api.json",
        "staff.json",
        "access_control.json",
        "accounts.json"
      ],
      "pathNormalizations": [
        {
          "file": "license.json",
          "basePath": "/v3",
          "transformations": [
            {
              "original": "/license/offerings",
              "normalized": "/v3/license/offerings",
              "basePath": "/v3"
            },
            {
              "original": "/license/offerings/{uid}",
              "normalized": "/v3/license/offerings/{uid}",
              "basePath": "/v3"
            },
            {
              "original": "/license/directory_offerings",
              "normalized": "/v3/license/directory_offerings",
              "basePath": "/v3"
            },
            {
              "original": "/license/directory_offerings/{uid}",
              "normalized": "/v3/license/directory_offerings/{uid}",
              "basePath": "/v3"
            },
            {
              "original": "/license/bundled_offerings",
              "normalized": "/v3/license/bundled_offerings",
              "basePath": "/v3"
            },
            {
              "original": "/license/bundled_offerings/bulk",
              "normalized": "/v3/license/bundled_offerings/bulk",
              "basePath": "/v3"
            },
            {
              "original": "/license/bundled_offerings/{uid}",
              "normalized": "/v3/license/bundled_offerings/{uid}",
              "basePath": "/v3"
            },
            {
              "original": "/license/subscriptions",
              "normalized": "/v3/license/subscriptions",
              "basePath": "/v3"
            },
            {
              "original": "/license/subscriptions/bulk",
              "normalized": "/v3/license/subscriptions/bulk",
              "basePath": "/v3"
            },
            {
              "original": "/license/subscriptions/{uid}",
              "normalized": "/v3/license/subscriptions/{uid}",
              "basePath": "/v3"
            },
            {
              "original": "/license/business_carts",
              "normalized": "/v3/license/business_carts",
              "basePath": "/v3"
            },
            {
              "original": "/license/business_carts/{uid}",
              "normalized": "/v3/license/business_carts/{uid}",
              "basePath": "/v3"
            },
            {
              "original": "/license/skus",
              "normalized": "/v3/license/skus",
              "basePath": "/v3"
            },
            {
              "original": "/license/features_packages",
              "normalized": "/v3/license/features_packages",
              "basePath": "/v3"
            },
            {
              "original": "/license/features",
              "normalized": "/v3/license/features",
              "basePath": "/v3"
            },
            {
              "original": "/license/features/{uid}",
              "normalized": "/v3/license/features/{uid}",
              "basePath": "/v3"
            },
            {
              "original": "/license/features_packages/{id}",
              "normalized": "/v3/license/features_packages/{id}",
              "basePath": "/v3"
            },
            {
              "original": "/license/features_packages/add_feature",
              "normalized": "/v3/license/features_packages/add_feature",
              "basePath": "/v3"
            },
            {
              "original": "/license/quota_consumptions",
              "normalized": "/v3/license/quota_consumptions",
              "basePath": "/v3"
            },
            {
              "original": "/license/quota_balances",
              "normalized": "/v3/license/quota_balances",
              "basePath": "/v3"
            }
          ]
        },
        {
          "file": "operator-portal.json",
          "basePath": "/api/operator_api/v1",
          "transformations": [
            {
              "original": "/packages",
              "normalized": "/api/operator_api/v1/packages",
              "basePath": "/api/operator_api/v1"
            },
            {
              "original": "/packages/{id}",
              "normalized": "/api/operator_api/v1/packages/{id}",
              "basePath": "/api/operator_api/v1"
            },
            {
              "original": "/packages/add_feature",
              "normalized": "/api/operator_api/v1/packages/add_feature",
              "basePath": "/api/operator_api/v1"
            },
            {
              "original": "/features",
              "normalized": "/api/operator_api/v1/features",
              "basePath": "/api/operator_api/v1"
            },
            {
              "original": "/features/{id}",
              "normalized": "/api/operator_api/v1/features/{id}",
              "basePath": "/api/operator_api/v1"
            }
          ]
        },
        {
          "file": "legacy_v1_platform.json",
          "basePath": "/platform/v1",
          "transformations": [
            {
              "original": "/businesses",
              "normalized": "/platform/v1/businesses",
              "basePath": "/platform/v1"
            },
            {
              "original": "/businesses/validate_login",
              "normalized": "/platform/v1/businesses/validate_login",
              "basePath": "/platform/v1"
            },
            {
              "original": "/businesses/verify_audience_claim",
              "normalized": "/platform/v1/businesses/verify_audience_claim",
              "basePath": "/platform/v1"
            },
            {
              "original": "/businesses/{business_uid}",
              "normalized": "/platform/v1/businesses/{business_uid}",
              "basePath": "/platform/v1"
            },
            {
              "original": "/directory/branding",
              "normalized": "/platform/v1/directory/branding",
              "basePath": "/platform/v1"
            },
            {
              "original": "/tokens",
              "normalized": "/platform/v1/tokens",
              "basePath": "/platform/v1"
            },
            {
              "original": "/tokens/revoke",
              "normalized": "/platform/v1/tokens/revoke",
              "basePath": "/platform/v1"
            },
            {
              "original": "/webhook/subscribe",
              "normalized": "/platform/v1/webhook/subscribe",
              "basePath": "/platform/v1"
            },
            {
              "original": "/webhook/unsubscribe",
              "normalized": "/platform/v1/webhook/unsubscribe",
              "basePath": "/platform/v1"
            },
            {
              "original": "/webhooks",
              "normalized": "/platform/v1/webhooks",
              "basePath": "/platform/v1"
            },
            {
              "original": "/businesses/{business_uid}/features",
              "normalized": "/platform/v1/businesses/{business_uid}/features",
              "basePath": "/platform/v1"
            },
            {
              "original": "/businesses/{business_uid}/purchased_items",
              "normalized": "/platform/v1/businesses/{business_uid}/purchased_items",
              "basePath": "/platform/v1"
            },
            {
              "original": "/businesses/{business_uid}/recurly_data",
              "normalized": "/platform/v1/businesses/{business_uid}/recurly_data",
              "basePath": "/platform/v1"
            },
            {
              "original": "/businesses/{business_uid}/staffs",
              "normalized": "/platform/v1/businesses/{business_uid}/staffs",
              "basePath": "/platform/v1"
            },
            {
              "original": "/businesses/{business_uid}/staffs/{staff_uid}",
              "normalized": "/platform/v1/businesses/{business_uid}/staffs/{staff_uid}",
              "basePath": "/platform/v1"
            },
            {
              "original": "/businesses/{business_uid}/staffs/{staff_uid}/sessions",
              "normalized": "/platform/v1/businesses/{business_uid}/staffs/{staff_uid}/sessions",
              "basePath": "/platform/v1"
            },
            {
              "original": "/businesses/{business_uid}/wizards",
              "normalized": "/platform/v1/businesses/{business_uid}/wizards",
              "basePath": "/platform/v1"
            },
            {
              "original": "/businesses/{business_uid}/wizards/{wizard_name}",
              "normalized": "/platform/v1/businesses/{business_uid}/wizards/{wizard_name}",
              "basePath": "/platform/v1"
            },
            {
              "original": "/scheduling/staff",
              "normalized": "/platform/v1/scheduling/staff",
              "basePath": "/platform/v1"
            },
            {
              "original": "/scheduling/staff/{staff_uid}",
              "normalized": "/platform/v1/scheduling/staff/{staff_uid}",
              "basePath": "/platform/v1"
            },
            {
              "original": "/business/jobber/flows",
              "normalized": "/platform/v1/business/jobber/flows",
              "basePath": "/platform/v1"
            },
            {
              "original": "/business/jobber/executions",
              "normalized": "/platform/v1/business/jobber/executions",
              "basePath": "/platform/v1"
            }
          ]
        },
        {
          "file": "staff.json",
          "basePath": "/business/staffs",
          "transformations": [
            {
              "original": "/v1/daily_staff_sign_ins",
              "normalized": "/business/staffs/v1/daily_staff_sign_ins",
              "basePath": "/business/staffs"
            },
            {
              "original": "/v1/staffs/{uid}",
              "normalized": "/business/staffs/v1/staffs/{uid}",
              "basePath": "/business/staffs"
            }
          ]
        },
        {
          "file": "oauth.json",
          "basePath": "/oauth",
          "transformations": [
            {
              "original": "/token",
              "normalized": "/oauth/token",
              "basePath": "/oauth"
            },
            {
              "original": "/userinfo",
              "normalized": "/oauth/userinfo",
              "basePath": "/oauth"
            }
          ]
        },
        {
          "file": "online_profiles.json",
          "basePath": "/v3/business_administration",
          "transformations": [
            {
              "original": "/online_profiles/{business_uid}",
              "normalized": "/v3/business_administration/online_profiles/{business_uid}",
              "basePath": "/v3/business_administration"
            },
            {
              "original": "/online_profiles",
              "normalized": "/v3/business_administration/online_profiles",
              "basePath": "/v3/business_administration"
            },
            {
              "original": "/online_profiles/{uid}",
              "normalized": "/v3/business_administration/online_profiles/{uid}",
              "basePath": "/v3/business_administration"
            }
          ]
        },
        {
          "file": "accounts.json",
          "basePath": "/business/accounts",
          "transformations": [
            {
              "original": "/v1/attributes",
              "normalized": "/business/accounts/v1/attributes",
              "basePath": "/business/accounts"
            },
            {
              "original": "/v1/branding",
              "normalized": "/business/accounts/v1/branding",
              "basePath": "/business/accounts"
            },
            {
              "original": "/v1/identities",
              "normalized": "/business/accounts/v1/identities",
              "basePath": "/business/accounts"
            },
            {
              "original": "/v1/usage/last_3_months_activity",
              "normalized": "/business/accounts/v1/usage/last_3_months_activity",
              "basePath": "/business/accounts"
            }
          ]
        }
      ],
      "pathConflicts": [],
      "componentConflicts": [
        {
          "type": "schema",
          "name": "ErrorResponse",
          "resolution": "Renamed to ErrorResponse_operator-portal",
          "files": [
            "merged",
            "operator-portal.json"
          ]
        },
        {
          "type": "schema",
          "name": "ErrorResponse",
          "resolution": "Renamed to ErrorResponse_directory",
          "files": [
            "merged",
            "directory.json"
          ]
        },
        {
          "type": "schema",
          "name": "Paging",
          "resolution": "Renamed to Paging_business",
          "files": [
            "merged",
            "business.json"
          ]
        },
        {
          "type": "schema",
          "name": "ErrorResponse",
          "resolution": "Renamed to ErrorResponse_online_profiles",
          "files": [
            "merged",
            "online_profiles.json"
          ]
        },
        {
          "type": "schema",
          "name": "ErrorResponse",
          "resolution": "Renamed to ErrorResponse_staff",
          "files": [
            "merged",
            "staff.json"
          ]
        }
      ],
      "totalPaths": 85,
      "totalComponents": 54
    }
  },
  "servers": [
    {
      "url": "https://api.vcita.biz",
      "description": "Unified API Gateway server"
    }
  ],
  "paths": {
    "/platform/v1/business/jobber/executions": {
      "get": {
        "description": "## Overview\nRetrieves the next scheduled execution time for a specific automation flow rule. This endpoint is useful for displaying when an automation will next run, allowing users to see upcoming execution times.\n\n## Use Cases\n- Display the next execution time for an automation flow\n- Show users when their scheduled automation will next run\n- Calculate and display countdown timers for upcoming executions\n- Validate that a flow has future executions scheduled\n\n## Response\nReturns the next execution time slot in the flow's configured timezone. The time is returned in a format that can be parsed and displayed to users.\n\nAvailable for **Staff and Directory tokens**.",
        "parameters": [
          {
            "description": "The unique identifier of the automation flow rule for which to retrieve the next execution time.",
            "in": "query",
            "name": "rule_uid",
            "required": true,
            "example": "ab35fa9d-a39e-4074-aae7-c3d2d3d84413",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Next execution time retrieved successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "properties": {
                        "time_slot": {
                          "description": "The next scheduled execution time in the format 'YYYY-MM-DD HH:MM:SS'. The time is in the timezone specified by the flow's time_zone_name.",
                          "type": "string",
                          "format": "date-time"
                        },
                        "rule_uid": {
                          "description": "The unique identifier of the automation flow rule",
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "status": {
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "example": {
                  "data": {
                    "time_slot": "2026-02-10 08:00:00",
                    "rule_uid": "ab35fa9d-a39e-4074-aae7-c3d2d3d84413"
                  },
                  "status": "OK"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid request parameters.",
            "content": {
              "application/json": {
                "example": {
                  "errors": [
                    {
                      "field": "rule_uid",
                      "code": "missing",
                      "message": "rule_uid is required"
                    }
                  ],
                  "status": "ERROR"
                }
              }
            }
          },
          "404": {
            "description": "Not Found - The specified rule_uid does not exist or has no future executions scheduled.",
            "content": {
              "application/json": {
                "example": {
                  "errors": [
                    {
                      "field": "rule_uid",
                      "code": "not_found",
                      "message": "Rule not found or no future executions scheduled"
                    }
                  ],
                  "status": "ERROR"
                }
              }
            }
          }
        },
        "summary": "Get Next Execution Time",
        "tags": [
          "Automation"
        ],
        "x-amazon-apigateway-auth": {
          "type": "NONE"
        },
        "x-amazon-apigateway-integration": {
          "httpMethod": "GET",
          "responses": {
            "default": {
              "statusCode": "200"
            }
          },
          "type": "http_proxy",
          "uri": "https:///business/jobber/executions"
        },
        "x-auth-type": "Application & Application User",
        "security": [
          {
            "Bearer": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "Bearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "Provide a valid bearer token in the Authorization header. Example: 'Authorization: Bearer {app_token}'"
      }
    }
  }
}
```