> ## 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.

# ListAssets

> List assets by group, name and status.

```text theme={null}
POST {BaseUrl}/?Action=ListAssets&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. Different fields are combined with AND.

**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. Multiple groups are combined with OR.

**Name** `string`

Fuzzy match on name.

**Statuses** `string[]`

Filter by status: `Active`, `Processing`, `Failed`.

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

Sort field: `CreateTime`, `UpdateTime` or `GroupId`.

**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 20000.

**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[]`

Assets, with the same fields as the `Result` of [GetAsset](https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/get-asset.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",
    "GroupIds": ["group-20261020080000-abcde"],
    "Statuses": ["Active"]
  },
  "MaxResults": 10,
  "SortBy": "CreateTime",
  "SortOrder": "Desc"
}
```

```json Page number pagination theme={null}
{
  "Filter": {
    "GroupType": "AIGC",
    "GroupIds": ["group-20261020080000-abcde"]
  },
  "PageNumber": 1,
  "PageSize": 10
}
```

```json 200 theme={null}
{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "ListAssets",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "Items": [
      {
        "Id": "asset-20261020080000-abcde",
        "GroupId": "group-20261020080000-abcde",
        "Name": "tea-reference",
        "AssetType": "Image",
        "Status": "Active",
        "URL": "https://media.example.com/reference.jpg?signature=xxx",
        "Moderation": {
          "Strategy": "Default"
        },
        "ProjectName": "default",
        "CreateTime": "2026-10-20T08:00:00Z",
        "UpdateTime": "2026-10-20T08:00:03Z"
      }
    ]
  }
}
```


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