---
title: "Get Machine Tasks"
method: GET
path: "/v1/Scheduling/schedule/machine-tasks"
tags: ["Scheduling"]
---

# Get Machine Tasks

`GET /v1/Scheduling/schedule/machine-tasks`

Retrieves a list of scheduled machine tasks based on various query parameters such as date range, machine, driver, route, and other filters.

## Query parameters

- `StartDate` string, date-time
- `EndDate` string, date-time
- `SchedulingId` integer
- `ActorId` integer
- `MachineId` integer
- `DriverId` string, uuid
- `RouteId` integer
- `TimePeriod` integer
- `IsForlist` boolean
- `IsStatic` boolean

## Response `200`

A list of scheduled machine tasks matching the specified criteria.

- TaskSchedulingResponseDto[]
  - `MachineId` integer — The unique identifier of the machine associated with the task.
  - `RouteId` integer, nullable — The unique identifier of the route associated with the task, if applicable.
  - `RouteName` string, nullable — The name of the route associated with the task, if applicable.
  - `VisitDate` string, date-time, nullable — The date and time of the scheduled visit.
  - `ScheduleTasks` ScheduleTaskDto[], nullable — A list of scheduled tasks associated with the machine.
    - `MachineId` integer — The unique identifier of the machine associated with the task.
    - `TaskLutId` string, nullable — The identifier for the type of task from the lookup table.
    - `SchedulingId` integer — The unique identifier of the scheduling instance.
    - `DriverId` string, uuid, nullable — The unique identifier of the driver assigned to the task.
    - `DriverName` string, nullable — The name of the driver assigned to the task.
    - `TimezoneOffset` number, double — The timezone offset in hours for the scheduled task.
    - `ScheduleDate` string, date-time, nullable — The date and time when the task is scheduled.
    - `StatusId` integer — The status identifier of the task.
    - `Notes` string, nullable — Additional notes related to the task.
    - `GeneratePickList` boolean — Indicates whether a pick list should be generated for the task.
    - `GeneratePickListTime` string, nullable — The time when the pick list is generated.
    - `GeneratePickListRange` integer, nullable — The range in minutes for generating the pick list.
    - `ScheduleNextWorkingDay` boolean — Indicates whether the task should be scheduled for the next working day.
    - `AssignedToPatternId` integer, nullable — The unique identifier of the pattern to which the task is assigned.
    - `AssignedToScheduleId` integer, nullable — The unique identifier of the schedule to which the task is assigned.
    - `IncompletionReason` string, nullable — The reason for task incompletion, if applicable.
    - `IncompletionReasonImages` EntityPicture[], nullable — A list of images associated with the reason for task incompletion.
      - `EntityPictureId` integer — The unique identifier of the entity picture.
      - `EntityPictureUrl` string, nullable — The URL of the entity picture.
    - `Pattern` Pattern
      - `PatternId` integer, nullable — The unique identifier of the pattern.
      - `Name` string, nullable — The name of the pattern.
      - `Description` string, nullable — The description of the pattern.
      - `RepeatType` integer, nullable — The type of repetition for the pattern (e.g., daily, weekly).
      - `RepeatInterval` integer — The interval of repetition for the pattern.
      - `IsStatic` boolean — Indicates whether the pattern is static.
      - `StartOn` string, date-time, nullable — The start date and time of the pattern.
      - `EndOn` string, date-time, nullable — The end date and time of the pattern.
      - `EndAfter` integer, nullable — The number of occurrences after which the pattern ends.
      - `RepeatOn` RepeatOn[], nullable — The days and weeks on which the pattern repeats.
        - `Tasks` string, nullable — The tasks associated with the repetition pattern.
        - `Days` string, nullable — The days of the week on which the tasks repeat.
        - `Week` string, nullable — The week of the month on which the tasks repeat.
        - `MonthDay` string, nullable — The day of the month on which the tasks repeat.
        - `SetPos` string, nullable — The position within the month (e.g., first, second) for the tasks to repeat.
        - `RecurrenceEx` string, nullable — Any exceptions to the recurrence pattern.
        - `WeekNumber` string, nullable — The week number within the recurrence period.
    - `IsClustered` boolean, nullable — Indicates whether the task is part of a clustered set of tasks.
    - `ClusterIds` string, nullable — The identifiers of the clustered tasks, if applicable.
    - `CreatedBy` integer — The unique identifier of the user who created the task.
    - `CreatedDt` string, date-time — The date and time when the task was created.
    - `UpdatedBy` integer, nullable — The unique identifier of the user who last updated the task.
    - `UpdatedDt` string, date-time, nullable — The date and time when the task was last updated.
    - `isMobile` boolean, nullable — Indicates whether the task was created or updated via a mobile device.
    - `isSeriesUpdate` boolean, nullable — Indicates whether the task is part of a series update.
    - `originalDate` string, nullable — The original date of the task before any rescheduling, if applicable.
    - `IncompletionReasonId` integer, nullable — The unique identifier of the reason for task incompletion.
    - `IncompletionReasonName` string, nullable — The name of the reason for task incompletion.

---

[API](https://skmtc.net/nayax/apis/nayax-cortina-api.md) · [All operations](https://skmtc.net/nayax/apis/nayax-cortina-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nayax/nayax-cortina-api/revisions/421f6f83c257/schema)