---
title: "List schedule files"
method: GET
path: "/schedule_files"
tags: ["Schedule Files"]
---

# List schedule files

`GET /schedule_files`

Returns the authenticated company's schedule files in reverse
chronological order.

**Required scope:** `read:schedule_files`

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Paginated list of schedule files

- object
  - `data` ScheduleFile[], required
    - `id` integer, required — Unique identifier for the schedule file.
    - `name` string, required — Human-readable name supplied when the file was uploaded.
    - `is_baseline` boolean, required — True if the file was marked as a baseline at upload time; baselines are preserved for variance reporting.
    - `company_id` integer, required — ID of the company that owns this file. Always equal to the authenticated client's company.
    - `customer_project` object, nullable, required — Project association if one was provided on upload. `null` for unassociated files.
      - `id` integer — Kroo-side project ID.
      - `name` string — Human-readable project name.
      - `source` string — Partner source the project was synced from (e.g. `procore`).
      - `customer_project_id` string — Project identifier in the source partner system.
    - `created_at` string, date-time, required — ISO 8601 timestamp of when the upload was accepted.
  - `meta` object, required
    - `page` integer, required — Current page (1-indexed).
    - `per_page` integer, required — Page size applied to this response.
    - `total_count` integer, required — Total number of schedule files for the authenticated company.
    - `total_pages` integer, required — Total number of pages at the current per_page.

## Other responses

- `401` — Missing or invalid token
- `403` — Token lacks required scope
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/getkroo/apis/kroo-api-v3.md) · [All operations](https://skmtc.net/getkroo/apis/kroo-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getkroo/kroo-api-v3/versions/1aeb2b609ff7/schema)