---
name: "getGyroCleanRecords"
mode: "api"
versionRequirements:
  - { name: "Base Library", version: "2.29.0" }
title: "Cleaning Record List"
---

## getGyroCleanRecords

> [VERSION] Base Library >= 2.29.0

### Description

Get cleaning records for a gyroscope-based robot vacuum

### Parameters

`Params`

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `params` | `GetGyroCleanRecordsParams` | Yes | Parameter object containing the device ID, a DP collection, and pagination info |

### Return Value

Type: `Promise<GetGyroCleanRecordsResponse>`

Promise that resolves to the gyroscope-based robot vacuum cleaning record list and total count

##### GetGyroCleanRecordsResponse

| Property | Type | Description |
| --- | --- | --- |
| `datas` | `GyroCleanRecord[]` | Cleaning record list |
| `totalCount` | `number` | Total count |

### Referenced Types

##### `interface` GetGyroCleanRecordsParams

| Property | Type | Description |
| --- | --- | --- |
| `devId` | `string` | Device ID |
| `dpIds` | `number[]` | DP ID set |
| `offset` | `number` | Pagination offset |
| `limit` | `number` | Page size |
| `userId` | `string` | User ID, default '0' |

##### `interface` GyroCleanRecord

| Property | Type | Description |
| --- | --- | --- |
| `dpId` | `number` | DP ID |
| `gid` | `number` | Map ID |
| `gmtCreate` | `number` | Record creation timestamp |
| `recordId` | `string` | Record ID |
| `uuid` | `string` | Device UUID |
| `value` | `string` | Record value |


### Examples

```js
const result = await ty.getGyroCleanRecords({
  devId: 'your-device-id',
  dpIds: [101, 102],
  offset: 0,
  limit: 10,
});
console.log(result.datas, result.totalCount);
```