# 获取日历
**注意事项**：为了更好地提升该接口的安全性与开放性，我们对其进行了升级。请尽快迁移至[新版本>>](https://open.larksuite.com/document/ukTMukTMukTM/uETM3YjLxEzN24SMxcjN)

该接口用于根据日历 ID 获取日历信息。
## 请求

基本 |  
---|---
HTTP URL | https://open.larksuite.com/open-apis/calendar/v3/calendar_list/:calendarId
HTTP Method | GET

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：获取与使用access_token](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

### 路径参数
|参数|类型|必须|说明|
|--|-----|--|----|
|calendarId|string|是|日历 ID，来源于 URL 路径|
## 响应
### 响应体
|参数|说明|
|--|--|
|code|返回码，非 200000 表示失败|
|msg|返回码的描述|
|data|返回的业务信息|
|&emsp;∟id|日历 ID|
|&emsp;∟summary|日历标题|
|&emsp;∟description|日历描述|
|&emsp;∟is_private|是否为私有日历, 私有日历不可被搜索|
|&emsp;∟default_access_role|用户的日历权限|
### 响应体示例
```json
{
    "code": 200000,
    "msg": "success",
    "data": {
          "id": "larksuite.com_xxxxxxxxxx@group.calendar.larksuite.com",
          "summary": "calendar title",
          "description": "calendar description",
          "default_access_role": "free_busy_reader"    
    }
}
```
### 错误码

具体可参考：[服务端错误码说明](https://open.larksuite.com/document/ukTMukTMukTM/ugjM14COyUjL4ITN)