Documentation

Find tutorials, guides and use case examples in the

Learning center

Get Schedule by Name (Paginated)

Description

Get Schedules by Name (Paginated) recupera listas de schedules filtrando por nombre. Admite coincidencia exacta y coincidencia parcial con comodines (%). Además, permite paginar los resultados mediante pageNumber y perPage.

Este endpoint es útil cuando no conoces el ID del schedule, pero sí su nombre (o parte de él) y necesitas navegar por conjuntos grandes de coincidencias.

Request URL

https://{controllerMachine}:{controllerPort}/api/v4/schedules/{scheduleName}/paginated

Exact match: Use the full name of the schedule (e.g., ReleaseSmokeTest)

Partial match: Use % as a wildcard (e.g., Release%, %SmokeTest)

Note: Since scheduleName is part of the path, special characters must be URL-encoded. The % character in the URL must be encoded as %25. 

Input parameters

Property Type Description Comments
scheduleName string Name or partial name of the schedule % can be used as a wildcard for flexible filtering
accessKey string Access token for authentication Sent as an HTTP header: AccessKey: {your-token}
pageNumber integer Page number to retrieve Default value: 1
perPage integer Number of items per page Default value: 1

Examples

Curl - Exact Match

curl -X GET \
  -H 'Accept: application/json' \
  -H 'AccessKey: ${ACCESS_KEY}' \
  'https://{controllerMachine}:{controllerPort}/api/v4/schedules/UAT/paginated?pageNumber=1&perPage=50'

Curl - Partial Match with Wildcard

curl -X GET \
  -H 'Accept: application/json' \
  -H 'AccessKey: ${ACCESS_KEY}' \
  'https://{controllerMachine}:{controllerPort}/api/v4/schedules/UAT%25/paginated?pageNumber=2&perPage=25'

PowerShell 

$headers = @{ AccessKey = $env:ACCESS_KEY }
$base = "https://{controllerMachine}:{controllerPort}/api/v4/schedules"
$name = [System.Uri]::EscapeDataString("UAT%")  # -> UAT%25
$page = 1; $size = 50
Invoke-WebRequest -Uri "$base/$name/paginated?pageNumber=$page&perPage=$size" `
  -Headers $headers -Method GET -ContentType "application/json"

Response

Details of a schedule will be returned as this response:

[{
  "CurrentPage": 0,
  "TotalPages": 0,
  "Data": [
    {
      "Recurring": {
        "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "ScheduleInfoId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "Type": "EverySecond",
        "Period": 0,
        "EndType": "NoEnd",
        "EndDateTime": "2025-10-30T11:04:45.942Z",
        "RunsToEnd": 0,
        "EveryMonth": {
          "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "ScheduleRecurringId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "UseExactDayOfMonth": true,
          "ExactDayOfMonthNumber": 0,
          "SpecificDayType": "First",
          "SpecificDayUnit": "Monday"
        },
        "EveryWeek": {
          "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "ScheduleRecurringId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "Monday": true,
          "Tuesday": true,
          "Wednesday": true,
          "Thursday": true,
          "Friday": true,
          "Saturday": true,
          "Sunday": true
        },
        "EveryDay": {
          "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "ScheduleRecurringId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "SkipWeekends": true
        },
        "EverySmallUnitOfTime": {
          "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "ScheduleRecurringId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "EveryDay": true,
          "Delay": 0
        }
      },
      "RunListSteps": [
        {
          "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "RunListStepId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "ScheduleInfoId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "StepIndex": 0,
          "StepName": "string",
          "StepStartCondition": "Always",
          "EnvironmentParallelization": "RunAllFlows",
          "StartOrder": "Defined",
          "Agents": [
            {
              "AgentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
              "AgentTitle": "string",
              "ConnectionType": "RemoteAgent"
            }
          ]
        }
      ],
      "Team": {
        "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "Title": "string"
      },
      "RunListInfoId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "IsEnabled": true,
      "IsScheduled": true,
      "StartDateTime": {
        "Value": "2025-10-30T11:04:45.942Z",
        "LocalDateTime": "2025-10-30T11:04:45.942Z",
        "UtcDateTime": "2025-10-30T11:04:45.942Z",
        "Ticks": 0
      },
      "AlreadyRunningBehavior": "QueueNextRun",
      "AgentBusyBehavior": "QueueNextRun",
      "ReserveAgentsStrategy": "ReserveAllAgentsForStepBeforeStartingStep",
      "IsStopIfFlowFailed": true,
      "FlowFailedCount": 0,
      "IsDisableScheduleIfFlowFailed": true,
      "FlowFailedCountToDisableSchedule": 0,
      "IsEnabledReTryPolicy": true,
      "ReTryPolicyType": "None",
      "CountOfReTryFlowIfFailed": 0,
      "FlowReportType": "None",
      "IsStopIfLateness": true,
      "EstimatedRunTimePrecision": 0,
      "IsStopAfterElapsedInterval": true,
      "StopIntervalMinutes": 0,
      "RevisionTimestamp": 0,
      "TimeZoneOffset": 0,
      "TimeZoneId": "string",
      "InternalVersion": 0,
      "CreatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "ModifiedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "AgentConfigurationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "Description": "string",
      "DateCreation": {
        "Value": "2025-10-30T11:04:45.942Z",
        "LocalDateTime": "2025-10-30T11:04:45.942Z",
        "UtcDateTime": "2025-10-30T11:04:45.942Z",
        "Ticks": 0
      },
      "DateModify": {
        "Value": "2025-10-30T11:04:45.942Z",
        "LocalDateTime": "2025-10-30T11:04:45.942Z",
        "UtcDateTime": "2025-10-30T11:04:45.942Z",
        "Ticks": 0
      },
      "Title": "string",
      "Type": "Folder",
      "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  ],
  "TotalRecords": 0,
  "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
]
 

 

Response object

Field Type Description Values
Recurring object Schedule recurrence configuration Includes Type, Period, EndType, EveryMonth, etc.
RunListSteps array Steps included in the schedule Includes agents, step index, conditions
Team object Team assigned to the schedule Id, Title
StartDateTime object Date/time when the schedule begins Value, LocalDateTime, Ticks
EstimatedRunTimePrecision number Expected run-time precision in seconds Numeric
IsStopAfterElapsedInterval boolean Stop execution after max interval True | False
StopIntervalMinutes number Time in minutes before stopping Numeric
RevisionTimestamp number Schedule versioning value Ticks format (numeric)
TimeZoneOffset number Offset from UTC e.g. 0 = UTC, 120 = GMT+2
CreatedBy string User who created the schedule GUID
ModifiedBy string User who last modified the schedule GUID
AgentConfigurationId string  Agent configuration profile GUID
RunListInfoId string Identifier for the run list GUID
Description string Textual description of the schedule Free text
IsEnabled boolean Is schedule Enabled/Disable status True | False
IsScheduled boolean Schedule type:
True: Scheduled
False: AdHoc		 True | False
DayOfWeek string Days of week the schedule runs on (if recurring) 'Monday', 'Tuesday', ..., 'EveryDay'
DailyWindowPeriodEnd string End time for the daily execution window HH:mm:ss
DailyWindowPeriodStart string Start time for the daily execution window HH:mm:ss
Repeat string Repeat mode of the schedule

'NoRepeat', 'RepeatEvery', 'StartRightAfterLastRun'
RepeatMinutes number Minutes between runs when repeat mode is 'RepeatEvery' Any positive number
AlreadyRunningBehavior string What to do if a run is already in progress 'queueNextRun', 'skip'
AgentBusyBehavior string What to do if agents are busy 'queueNextRun', 'skip'
ReserveAgentsStrategy string Agent reservation policy 'reserveAllAgentsForStepBeforeStartingStep'
IsStopIfFlowFailed boolean Stop the schedule if any flow fails True | False
FlowFailedCount number Number of failed flows in the last run 0 or greater
IsDisableScheduleIfFlowFailed boolean Whether to disable the schedule after repeated failures True | False
FlowFailedCountToDisableSchedule number Threshold of failures before schedule gets disabled 0 or greater
IsEnabledReTryPolicy boolean Whether retry policy is enabled True | False
ReTryPolicyType string Type of retry policy 'none', 'immediate', 'delayed'
CountOfReTryFlowIfFailed number Number of retry attempts for failed flows 0 or greater
TimeZoneId string Time zone in which the schedule is configured e.g. 'UTC', 'Europe/Copenhagen'
Title string Name of the schedule e.g. 'UAT Nightly'
Type string Type of object 'ScheduleInfo' or 'folder'
Id string Unique ID of the schedule GUID
CurrentPage number The current page number (0-based or 1-based depending on implementation)  
TotalPages number Total number of pages available  
TotalRecords number Total number of matching records  
Data array Array of schedule objects. Each object has the same structure as in the non-paginated Get Schedule by Name endpoint  
Id string Identifier for the result set or correlation ID (optional)  

Response Code

200 (OK)

404 (Not Found)

401 (Unauthorized)

400 (Bad Request)

405 (Method Not Allowed)

500 (Internal Server Error)

Product
Company
  • Our story
  • Leadership
  • Customers
  • Blog
  • Events and webinars
  • Resource hub
  • Careers We're hiring!
  • News
  • Legal
    • Support
  • Knowledge base
  • Documentation
  • Technical support
    • Contact

    Americas

    info-americas@leapwork.com

    +1 415 237 1060


    EMEA

    info-emea@leapwork.com

    +45 35 25 14 14

    ©2024, Leapwork. All rights reserved.

    Cookie preferences | Impressum