---
title: "List business calendars"
method: GET
path: "/calendars"
tags: ["dags"]
---

# List business calendars

`GET /calendars`

## Request

- Base URL: `http://localhost/api/v1`
- URL: `http://localhost/api/v1/calendars`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
  - none

Lists the built-in calendars and the calendar files that start schedules can name.

## Query parameters

- `remoteNode` string
- `includeUsage` boolean

## Response `200`

Calendars, sorted by name

- object
  - `calendars` CalendarSummary[], required
    - `name` string, required
    - `description` string
    - `through` string, date: Last date the calendar's holidays are maintained for
    - `builtin` boolean, required: Whether the calendar is built in rather than a file
    - `error` string: Why the calendar file does not load
    - `warning` string: Why the calendar needs attention, such as holidays that run out soon
    - `includes` string[]: Calendars whose holidays this calendar adds
    - `dagCount` integer: Number of DAGs whose start schedules use the calendar, directly or through calendars that include it. Set when usage is requested.

## Other responses

- `default`: Unexpected error

## Changes

> 208 revisions in range; 1 not diffed.

- **2026-11-01** (v1) `d6b5f3398212`: 4 info
  - added the new optional `query` request parameter `includeUsage`
  - added the optional property `calendars/items/dagCount` to the response with the `200` status
  - added the optional property `calendars/items/includes` to the response with the `200` status
  - added the optional property `calendars/items/warning` to the response with the `200` status
- **2026-11-01** (v1) `b87f288efe47`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/dagucloud/apis/dagu/changes/calendars/get.md)

---

[API](https://skmtc.dev/dagucloud/apis/dagu.md) - [All operations](https://skmtc.dev/dagucloud/apis/dagu/llms.txt) - [OpenAPI document](https://skmtc.dev/dagucloud/apis/dagu/revisions/4f7617b01d17?raw)