---
title: "Get employees who are currently late or were late in the given time range."
method: GET
path: "/agent/schedule/v2/late"
tags: ["Schedule Agent"]
---

# Get employees who are currently late or were late in the given time range.

`GET /agent/schedule/v2/late`

## Request

- Base URL: `https://your-subdomain.deputy.deputy.com/api`
- URL: `https://your-subdomain.deputy.deputy.com/api/agent/schedule/v2/late`
- Auth: API key in header `OAuth`

Note: This endpoint processes a maximum of 1000 rosters per request to ensure
reliable performance. For businesses with more shifts in the given time range,
use shorter time ranges or filter by specific locations to ensure all late
employees are captured.

## Query parameters

- `startDate` string
- `endDate` string
- `locationIds` integer[]
- `cursor` string
- `limit` integer

## Response `200`

A successful response.

- ScheduleAgentGetLateResponse
  - `success` boolean
  - `data` ScheduleAgentLateEntry[]
    - `employeeId` integer
    - `employeeName` string
    - `shift` ScheduleAgentShiftInfo
      - `id` integer
      - `startTime` string
      - `endTime` string
      - `areaId` integer
      - `areaName` string
      - `locationId` integer
      - `locationName` string
    - `timesheet` ScheduleAgentTimesheetInfo
      - `id` integer
      - `startTime` string
      - `endTime` string
    - `minutesLate` integer
    - `status` 'UNKNOWN' | 'CURRENTLY_LATE' | 'LATE'
  - `metadata` ScheduleAgentMetadata
    - `nextCursor` string

---

[API](https://skmtc.dev/deputy/apis/deputy-v2-api.md) - [All operations](https://skmtc.dev/deputy/apis/deputy-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/deputy/apis/deputy-v2-api/revisions/78f0278f4608?raw)
