> ## Documentation Index
> Fetch the complete documentation index at: https://docs-vip.apigo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ListAssetGroups

> List asset groups by filter.

```text theme={null}
POST {BaseUrl}/?Action=ListAssetGroups&Version=2024-01-01
Content-Type: application/json
```

Requests must be signed with HMAC-SHA256. See [Authentication and conventions](https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/asset-overview.md#authentication).

## Request parameters

**Filter** `object` *required*

Filter conditions.

**properties**

**GroupType** `string` *required*

Group type: `AIGC` (regular group) or `LivenessFace` ([real-person group](https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/asset-overview.md#real-person-assets)).

**GroupIds** `string[]`

Filter by group IDs.

**Name** `string`

Fuzzy match on name.

**SortBy** `string` (default: CreateTime)

Sort field: `CreateTime` or `UpdateTime`.

**SortOrder** `string` (default: Desc)

Sort order: `Asc` or `Desc`.

**MaxResults** `integer` (default: 10)

Items per page for NextToken pagination, 1–100.

**NextToken** `string`

Page token for NextToken pagination. Omit on the first request.

**PageNumber** `integer`

Page number for page number pagination, starting at 1. Must be passed with `PageSize`.

**PageSize** `integer`

Items per page for page number pagination, 1–100. `PageNumber × PageSize` cannot exceed 10000.

**ProjectName** `string`

Pass `default` or omit.

See [Pagination](https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/asset-overview.md#pagination) for the rules of both modes.

## Response parameters

**Result.Items** `object[]`

Asset groups, with the same fields as the `Result` of [GetAssetGroup](https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/get-asset-group.md). Empty array when nothing matches.

**Result.NextToken** `string`

Token for the next page. Returned only in NextToken pagination when more pages exist.

**Result.TotalCount** `integer`

Total matching items. Page number pagination only.

**Result.PageNumber** `integer`

Current page number. Page number pagination only.

**Result.PageSize** `integer`

Items per page. Page number pagination only.

```json NextToken pagination theme={null}
{
  "Filter": {
    "GroupType": "AIGC",
    "Name": "product"
  },
  "MaxResults": 10,
  "SortBy": "CreateTime",
  "SortOrder": "Desc"
}
```

```json Page number pagination theme={null}
{
  "Filter": {
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}
```

```json NextToken pagination theme={null}
{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "ListAssetGroups",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "Items": [
      {
        "Id": "group-20261020080000-abcde",
        "Name": "product-assets",
        "Description": "Reference assets for product ads",
        "GroupType": "AIGC",
        "ProjectName": "default",
        "CreateTime": "2026-10-20T08:00:00Z",
        "UpdateTime": "2026-10-20T08:00:00Z"
      }
    ],
    "NextToken": "Q3JlYXRlVGltZToxNzkyMzk2ODAw"
  }
}
```

```json Page number pagination theme={null}
{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "ListAssetGroups",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "Items": [],
    "TotalCount": 0,
    "PageNumber": 1,
    "PageSize": 10
  }
}
```


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