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

# List assets

`GET /v1/assets/`

## Request

- Base URL: `https://api.ethiack.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ethiack.com/v1/assets/`
- Auth: none declared

List assets visible to the caller, filtered and paginated.

Mirrors api-3's ``PaginatedAssetsFilter`` (``asset_id``,
``organization_id``, ``page``, ``per_page``). Authorization scoping
is enforced by ``AssetService``; the route only translates transport.

Args:
    db (AsyncSession): Request-scoped database session.
    context (ActiveContext): Resolved caller identity and scope.
    query (AssetListQuery): Filters + pagination query params.
    pager (Paginator): Fills the response's navigation metadata.

Returns:
    AssetListResponse: The authorized, paginated asset list.

## Query parameters

- `page` integer
- `per_page` integer: Page size. Values above 500 are clamped to it (or rejected, per REST__PAGINATION__PER_PAGE_OVER_MAX).
- `asset_id` integer, nullable
- `organization_id` integer, nullable

## Response `200`

Successful Response

- AssetListResponse: Paginated list of assets. Matches api-3's ``AssetList`` schema. Attributes: assets (list[AssetResponse]): Asset objects.
  - `total` integer, nullable
  - `page` integer, nullable
  - `per_page` integer, nullable
  - `_links` object, nullable: RFC 8288 rel to URL. Always first; last unless the route opted out of counting; prev and next when applicable.
  - `assets` AssetResponse[], required
    - `id` integer, required
    - `value` string, required
    - `type` string, required
    - `tier` 'low' | 'medium' | 'high': Tier (importance level) of an asset. Stored as the lowercase token (``low``/``medium``/``high``) — the same value the public API uses, so no wire<->storage mapping is needed.
    - `organization_id` integer, required
    - `private` boolean, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ethiack/apis/ethiack-api.md) - [All operations](https://skmtc.dev/ethiack/apis/ethiack-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ethiack/apis/ethiack-api/revisions/4eaba89bfebf?raw)