查询企业考勤排班详情

POST

/topapi/attendance/listschedule

接口调用量说明钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，查询企业某天所有员工考勤排班信息。

调用本接口，查询企业考勤排班详情，获取员工的班次信息、排班信息等。

重要

固定班制只能查到未来15天的排班信息。

本接口仅支持企业总人数10000人以下使用。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	默认开通，无需申请	调试
第三方企业应用	是	默认开通，无需申请	调试
第三方个人应用	否	—	—

请求参数

Query 参数

Body 参数application/json

示例

{
        "workDate":"2016-03-09",
        "offset":0,
        "size":200
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/topapi/attendance/listschedule?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
        "workDate":"2016-03-09",
        "offset":0,
        "size":200
}'

返回响应

🟢200成功

application/json

Body

示例

成功示例成功示例

{}

修改于 2025-09-08 06:28:05

查询排班打卡结果

批量查询成员排班概要信息

查询企业考勤排班详情

权限#

请求参数

请求示例代码

返回响应

权限