# 查询员工离职原因列表
该接口用于查询[离职配置](https://people.feishu.cn/people/hr-settings/dimission/setting)> 离职原因的选项信息，包括离职原因选项的唯一标识、名称和启用状态等信息。
## 请求
基本 |
---|---
HTTP URL | https://open.feishu.cn/open-apis/corehr/v1/offboardings/query
HTTP Method | POST
接口频率限制 | [100 次/分钟](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
支持的应用类型 | Custom App、Store App
权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用**
开启任一权限即可 | 获取预置数据信息(corehr:common_data.preset_data:read)
获取核心人事信息(corehr:corehr:readonly)
更新核心人事信息(corehr:corehr)
更新预置数据信息(corehr:common_data.preset_data:write)
### 请求头
名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"
[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"
### 请求体
名称 | 类型 | 必填 | 描述
---|---|---|---
active | boolean | 否 | 离职原因状态，为空时默认搜索所有状态的离职原因。可选项有:
-true: 启用
-false: 停用
**示例值**：true
offboarding_reason_unique_identifier | string\[\] | 否 | 离职原因唯一标识列表，用于过滤离职原因，为空时默认搜索所有离职原因，最多支持20个
**示例值**：["offboarding_reason_unique_identifier"]
### 请求体示例
```json
{
"active": true,
"offboarding_reason_unique_identifier": [
"offboarding_reason_unique_identifier"
]
}
```
## 响应
### 响应体
名称 | 类型 | 描述
---|---|---
code | int | 错误码，非 0 表示失败
msg | string | 错误描述
data | \- | \-
items | offboarding_reason\[\] | 离职原因列表
offboarding_reason_unique_identifier | string | 离职原因唯一标识，可用于开放平台[操作员工离职](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/offboarding/submit)、[搜索离职信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/offboarding/search)等接口入参中的离职原因。
name | i18n\[\] | 名称
lang | string | 名称信息的语言
value | string | 名称信息的内容
active | boolean | 是否启用，可选项有：
- true
- false
parent_offboarding_reason_unique_identifier | string | 当前离职原因的父级原因唯一标识
created_time | string | 创建时间，格式："YYYY-MM-DD HH-mm-ss"
updated_time | string | 更新时间，格式："YYYY-MM-DD HH-mm-ss"
### 响应体示例
```json
{
"code": 0,
"msg": "success",
"data": {
"items": [
{
"offboarding_reason_unique_identifier": "reason_for_offboarding_option8",
"name": [
{
"lang": "zh-CN",
"value": "张三"
}
],
"active": true,
"parent_offboarding_reason_unique_identifier": "offboarding_reason_1",
"created_time": "2021-08-20 20:28:23",
"updated_time": "2022-01-07 17:21:06"
}
]
}
}
```
### 错误码
HTTP状态码 | 错误码 | 描述 | 排查建议
---|---|---|---
500 | 1160103 | general internal server error code | 调用上下游系统错误，重试后仍报错，请咨询[技术支持](https://applink.feishu.cn/TLJpeNdW)。
500 | 1160201 | has approving offboarding | 存在「审批中」或「待生效」的离职申请，请先撤销后再申请
500 | 1160203 | no current contract | 所选离职日期无生效中的合同，请确认合同信息后重新提交
500 | 1160204 | has future contract | 存在晚于离职日期生效的合同，请确认合同信息后重新提交
500 | 1160205 | contract has actual end date | 离职日期时的合同已存在实际结束日期，请确认合同信息后重新提交
500 | 1160210 | has offboarding record | 存在「审批中」或「待生效」的离职申请，请先撤销后再申请
500 | 1160602 | offboarding is earlier than probation | 存在晚于离职日期的转正记录，请重新选择离职日期或先撤销试用期转正申请
500 | 1160603 | offboarding is earlier than transform | 存在晚于离职日期的异动记录，请重新选择离职日期或先撤销异动申请
400 | 1160604 | reason explanation length exceed maximum | 离职原因说明长度超过最大限制(6000)
500 | 1160616 | no valid job data | 该员工没有合法的任职记录，请确认任职记录后重新提交
500 | 1161000 | unknown error | 调用上下游系统错误，重试后仍报错，请咨询[技术支持](https://applink.feishu.cn/TLJpeNdW)。