---
title: "Export assets as CSV"
method: GET
path: "/v1/assets/export"
tags: ["assets"]
---

# Export assets as CSV

`GET /v1/assets/export`

## 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/export`
- Auth: none declared

Export every asset the caller may see as CSV.

A ``type,value,beacon`` header precedes one row per asset, where
``type`` is the export label
(see :func:`_export_type_label`), ``value`` is the asset value, and
``beacon`` is the owning beacon's name (empty for non-beacon assets).
Assets are Cerbos-scoped by ``AssetService``; beacon names come from a
second Cerbos-scoped ``BeaconService`` read, skipped (leaving the column
empty) when the plan lacks the ``beacon`` feature. Built in memory and
returned inline (see ``scans.py`` for why this is not the async
documents pipeline).

Args:
    db (AsyncSession): Request-scoped database session.
    context (ActiveContext): Resolved caller identity and scope.
    query (AssetExportQuery): Optional ``organization_id`` filter.

Returns:
    Response: A ``text/csv`` download of the authorized assets.

## Query parameters

- `organization_id` integer, nullable

## Response `200`

CSV export of every asset visible to the caller, with a ``type,value,beacon`` header.

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