---
title: "Create Year to Date Report"
method: POST
path: "/reports/ytd"
---

# Create Year to Date Report

`POST /reports/ytd`

Create a year-to-date report.

## Request body

- object
  - `companyID` string, required — The ID of the company
  - `employeeID` string[] — Array of employee IDs to grab YTD data for. If this field is omitted, or an empty array is provided, then the report will include all employees
  - `year` string, required — The year to query for the report
  - `media_type` 'json' | 'csv', required — The media_type of the report
  - `include_migrated` boolean — Include migrated data in the report

## Response `200`

200

- object
  - `success` boolean
  - `data` object
    - `job_id` string
    - `status` string
    - `request_body` object
      - `companyID` string
      - `employeeID` string[]
      - `year` string
      - `media_type` string
      - `has_live_key` boolean
      - `job_type` string
      - `report_format` string
    - `created_at` string

## Other responses

- `400` — 400

---

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