---
title: "Get a business calendar"
method: GET
path: "/calendars/{name}"
tags: ["dags"]
---

# Get a business calendar

`GET /calendars/{name}`

## Request

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

Returns a calendar's file content, its problems, and the calendars and DAGs that depend on it. DAGs in workspaces the caller cannot see are not listed.

## Path parameters

- `name` string, required: Name of a business calendar: a built-in one, or the file <name>.yaml in paths.calendars_dir

## Query parameters

- `remoteNode` string

## Response `200`

The calendar

- CalendarDetails: A business calendar with its file content and what depends on it
  - `name` string, required: Name of a business calendar: a built-in one, or the file <name>.yaml in paths.calendars_dir
  - `builtin` boolean, required: Whether the calendar is built in rather than a file
  - `description` string
  - `through` string, date: Last date the calendar's holidays are maintained for
  - `spec` string, required: The calendar file's content; empty for a built-in calendar
  - `errors` string[], required: Problems of the saved file, each starting with its [line:column] in the file when it has one
  - `warnings` string[], required
  - `includes` string[], required: Calendars whose holidays this calendar adds
  - `includedBy` string[], required: Calendars that add this calendar's holidays, directly or through other calendars
  - `usedBy` CalendarUser[], required: DAGs whose start schedules use the calendar, directly or through calendars that include it
    - `fileName` string, regex, required: Name of the DAG file
    - `name` string, required: Name of the DAG
    - `workspace` string: Workspace the DAG belongs to, if any
    - `via` string: The calendar the DAG names, when it uses this calendar through includes

## Other responses

- `404`: No calendar has the name
- `default`: Unexpected error

## Changes

> 208 revisions in range; 1 not diffed.

- **2026-11-01** (v1) `d6b5f3398212`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/dagucloud/apis/dagu/changes/calendars/:name/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/742c8ecb39ce?raw)