---
title: "Preview Asset Import"
method: POST
path: "/api/assets/import/preview"
tags: ["assets"]
---

# Preview Asset Import

`POST /api/assets/import/preview`

## Request

- Base URL: `https://demo.usesecuro.com` (the document declares no server; this is the origin it was published from)
- URL: `https://demo.usesecuro.com/api/assets/import/preview`
- Auth: OAuth 2
  - Password
  - Token URL: `/api/auth/login`
- TypeScript: <https://skmtc.dev/usesecuro/apis/securo/docs/api/assets/import/preview/post.ts> (a function with typed inputs; its response is checked against the schema)

Read the file and say what importing it would do. Writes nothing.

Read-gated on purpose, like the transaction preview: a viewer may look at
a file without being able to commit it.

## Headers

- `X-Workspace-Id` string, nullable

## Request body `multipart/form-data`

- BodyPreviewAssetImportApiAssetsImportPreviewPost
  - `file` string, binary, required
  - `column_mapping` string, nullable
  - `date_format` string, nullable
  - `group_id` string, uuid, nullable

## Response `200`

Successful Response

- AssetImportPreview
  - `orders` AssetOrderImportOutput[], required
    - `row` integer, required
    - `ticker` string, required
    - `date` string, date, required
    - `kind` string, required
    - `quantity` string, required
    - `price` string, required
    - `fee` string
    - `currency` string, nullable
    - `name` string, nullable
    - `notes` string, nullable
    - `external_id` string, nullable
  - `errors` AssetImportRowError[]
    - `row` integer, required
    - `reason` string, required
    - `ticker` string, nullable
    - `detail` string, nullable
  - `warnings` AssetImportWarning[]
    - `ticker` string, required
    - `reason` string, required
    - `wallet` string, nullable
  - `csv_columns` string[]
  - `parse_error` string, nullable
  - `holdings_created` integer
  - `holdings_matched` integer
  - `skipped` integer

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-05** `416a7752fec4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usesecuro/apis/securo/changes/api/assets/import/preview/post.md)

---

[API](https://skmtc.dev/usesecuro/apis/securo.md) - [All operations](https://skmtc.dev/usesecuro/apis/securo/llms.txt) - [OpenAPI document](https://skmtc.dev/usesecuro/apis/securo/revisions/416a7752fec4?raw)