---
title: "List assets"
method: GET
path: "/asset"
tags: ["Asset"]
---

# List assets

`GET /asset`

Lists assets by `build_id`.

## Query parameters

- `offset` integer
- `limit` integer
- `build_id` integer, required
- `type` 'docker-image' | 'lambda' | 'bundle'
- `platform` 'x86_64' | 'arm_64'

## Response `200`

A list of assets.

- AssetListResponse[]
  - `paging` object, required
    - `total` integer, required — The total number of results matching the query.
    - `offset` integer, required — The starting point for pagination. Defaults to 0 if not provided.
    - `limit` integer, required — The maximum number of results to return per page. The maximum allowed value is 200.
  - `results` AssetResponse[], required
    - `id` integer, required — The ID of the asset.
    - `name` string — The name of the asset.
    - `build_id` integer, required — The ID of the build that the asset belongs to.
    - `type` 'docker-image' | 'lambda' | 'bundle', required — The type of the asset.
    - `platform` 'x86_64' | 'arm_64' — The platform of the asset.
    - `url` string, uri, required — The url of the asset. > •For docker-image assets, this should be the local tagged image or image name. > > •For lambda assets, this should be the file path of the lambda package.
    - `nrn` string — The resource name (NRN) uniquely identifying the asset.
    - `branch` string — The branch that the asset was built from.
    - `commit` object
      - `id` integer — The ID of the commit that the asset was built from.
      - `permalink` string — The permalink to the commit that the asset was built from.

## Other responses

- `4XX` — Client error responses due to invalid input or missing parameters.
- `5XX` — Server error responses indicating an issue on the API side.

---

[API](https://skmtc.dev/nullplatform/apis/nullplatform-api.md) · [All operations](https://skmtc.dev/nullplatform/apis/nullplatform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nullplatform/nullplatform-api/revisions/1c4ea154b159/schema)