> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Batch Get Attendance Group Summaries

> Call this API to get summaries of all attendance groups using a pagination cursor, including each group's name and ID.

Call this API to get summaries of all attendance groups in your organization by page, including each attendance group name and its corresponding attendance group ID.

## Request

| **Basic Information** | |
| - | - |
| HTTP URL | [https://api.dingtalk.io/topapi/attendance/group/minimalism/list](https://api.dingtalk.io/topapi/attendance/group/minimalism/list) |
| HTTP Method | POST |
| Supported app types | appType-Internal app　appType-Third-party enterprise app |
| Permissions | permission-qyapi\_attendance\_group\_read-Attendance group read permission |

### Query Parameters

| Name | Type | Required | Example | Description |
| - | - | - | - | - |
| access\_token | String | Yes | bE74xxxx | The app credential used to call this API.   - For an Internal app, get it by calling [Get the access\_token of an Internal App](https://help.dingtalk.io/open/development/obtain-orgapp-token). - For a Third-party enterprise app, get it by calling the API for getting the access\_token of a third-party organization. |

### Request Body

| Name | Type | Required | Example | Description |
| - | - | - | - | - |
| op\_user\_id | String | Yes | user123 | The userId of the operator. |
| cursor | Number | No | 222 | The pagination cursor. Get it from the result of the previous request. If omitted, the query starts from the first item. |

### Request Example

```curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.dingtalk.io/topapi/attendance/group/minimalism/list" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=6dd4xxxx94138' \
-d 'cursor=222' \
-d 'op_user_id=dd_dd'
```

Java

```java theme={"theme":{"light":"github-light","dark":"github-dark"}}
DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/group/minimalism/list");
OapiAttendanceGroupMinimalismListRequest req = new OapiAttendanceGroupMinimalismListRequest();
req.setOpUserId("manager4220");
req.setCursor(0L);
OapiAttendanceGroupMinimalismListResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());
```

Python

```python theme={"theme":{"light":"github-light","dark":"github-dark"}}
import dingtalk.api

req=dingtalk.api.OapiAttendanceGroupMinimalismListRequest("https://api.dingtalk.io/topapi/attendance/group/minimalism/list")

req.op_user_id="dd_dd"
req.cursor=222
try:
  resp= req.getResponse(access_token)
  print(resp)
except Exception,e:
  print(e)
```

PHP

```php theme={"theme":{"light":"github-light","dark":"github-dark"}}
include "TopSdk.php";
date_default_timezone_set('Asia/Shanghai');

$c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_OAPI, DingTalkConstant::$METHOD_POST , DingTalkConstant::$FORMAT_JSON);
$req = new OapiAttendanceGroupMinimalismListRequest;
$req->setOpUserId("dd_dd");
$req->setCursor("222");
$resp = $c->execute($req, $access_token, "https://api.dingtalk.io/topapi/attendance/group/minimalism/list");
```

C#

```csharp theme={"theme":{"light":"github-light","dark":"github-dark"}}
IDingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/attendance/group/minimalism/list");
OapiAttendanceGroupMinimalismListRequest req = new OapiAttendanceGroupMinimalismListRequest();
req.OpUserId = "dd_dd";
req.Cursor = 222L;
OapiAttendanceGroupMinimalismListResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);
```

## Response

### Response Body

| Name | Type | Example | Description |
| - | - | - | - |
| result | PageResult | demo | The returned result. |
| has\_more | Boolean | false | Indicates whether more data is available.   - **true**: Yes - **false**: No |
| cursor | Number | 685935028 | The cursor position. |
| result | TopMinimalismGroupVo\[] | | The attendance information. |
| name | String | Attendance | The attendance group name. |
| id | Number | 677765054 | The attendance group ID. |
| success | Boolean | true | Indicates whether the request succeeded.   - **true**: Success - **false**: Failed |
| errcode | Number | 0 | The return code. |
| errmsg | String | ok | The error message description. |
| request\_id | String | wv9973jntam | The request ID. |

### Response Body Example

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "errcode": 0,
  "result": {
    "cursor": 685935028,
    "has_more": false,
    "result": [
      {
        "id": 677765054,
        "name": "Weekend Overtime"
      },
      {
        "id": 685935028,
        "name": "Attendance"
      }
    ]
  },
  "success": true,
  "request_id": "wv9973jntamw"
}
```

### Error Codes

If a call to this API returns an error, find the solution based on the error message in the [Global Error Codes](https://help.dingtalk.io/open/development/server-api-error-codes-1.md) document.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.