---
title: "/assets"
method: GET
path: "/v1/assets"
tags: ["Assets"]
---

# /assets

`GET /v1/assets`

Get a list of assets.

Sorted by coverVersion.updatedAt descending (most recently updated asset version first).

## Query parameters

- `limit` string
- `cursor` string
- `parentBoardId` string
- `includeNestedAssets` boolean
- `search` string
- `tag` string
- `customField` string
- `createdAt` object
  - `gte` string, date-time — Filter assets created on or after this date
  - `lte` string, date-time — Filter assets created on or before this date

## Response `200`

Filter by tag

- object
  - `data` object[]
    - `id` string
    - `customFields` object[]
      - `id` string
      - `name` string
      - `type` 'single-select' | 'multi-select' | 'plain-text' | 'date' — The type of custom field
      - `values` object[]
        - `id` string
        - `name` string
    - `coverVersion` object
      - `id` string
      - `fileName` string
      - `description` string
      - `summary` string, nullable
      - `smartTags` object[]
        - `name` string
      - `ext` string
      - `title` string
      - `type` string
      - `createdAt` string, style
      - `uploadedAt` string
      - `fileCreatedAt` string, style
      - `width` integer
      - `height` integer
      - `size` integer
      - `tags` object[]
        - `id` string
        - `label` string
      - `urls` object
        - `thumbnail` string, uri
        - `preview` string, uri
  - `pagination` object
    - `hasMore` boolean
    - `cursor` unknown
  - `total` integer

---

[API](https://skmtc.net/air/apis/air-api.md) · [All operations](https://skmtc.net/air/apis/air-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/air/air-api/versions/2bd9c9fa2a0c/schema)