---
title: "GET /v1/portfolios/{portfolioSlug}/transaction-imports"
method: GET
path: "/v1/portfolios/{portfolioSlug}/transaction-imports"
tags: ["TransactionImports"]
---

# GET /v1/portfolios/{portfolioSlug}/transaction-imports

`GET /v1/portfolios/{portfolioSlug}/transaction-imports`

## Request

- Base URL: `https://api.tokenbooks.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tokenbooks.io/v1/portfolios/{portfolioSlug}/transaction-imports`
- Auth: API key in header `x-api-key`

## Path parameters

- `portfolioSlug` string, required

## Query parameters

- `pageSize` integer: Requested number of resources to return. Oversized values are clamped to the route limit.
- `pageToken` string: Opaque token returned by the previous list response.
- `chainId` string: Optional wallet chain filter used with walletAddress
- `fromDate` union: Optional inclusive import-created-at lower bound
  - string, date-time
  - string
- `status` 'UPLOADED' | 'ANALYZING' | 'PREVIEW_READY' | 'FINALIZING' | 'COMMITTED' | 'FAILED' | 'DELETED': Optional lifecycle status filter. Omit to include active imports, committed imports, and retryable deleted imports with pending undo replay.
- `toDate` union: Optional inclusive import-created-at upper bound
  - string, date-time
  - string
- `walletAddress` string: Optional wallet address filter used with chainId

## Response `200`

- TransactionImportHistoryListResponseDto
  - `data` object[], required
    - `auditPresentmentAvailable` boolean, required: Whether a retained audit presentment can be exported
    - `chainId` string, required: Wallet chain ID declared for import
    - `commitResult` object, nullable, required: Durable actual finalize result, or null when unavailable
      - `committedAt` string, date-time, required
      - `importedCount` integer, required
      - `skippedCount` integer, required
    - `counts` object, required: Planned preview record counts captured during analysis
      - `excluded` integer, required
      - `flagged` integer, required
      - `hasUnresolved` integer, required
      - `inLedger` integer, required
      - `pending` integer, required
      - `resolved` integer, required
      - `sourceRows` integer, required
      - `totalRecords` integer, required
      - `warnings` integer, required
    - `createdAt` string, date-time, required: Import creation timestamp
    - `declaredName` string, nullable, required: User-provided wallet name, or null when none was provided
    - `importRef` string, required: Public transaction import reference
    - `sourceFileAvailable` boolean, required: Whether the original uploaded source file can be downloaded
    - `sourceFileName` string, nullable, required: Original uploaded file name for display, or null when unavailable
    - `status` 'UPLOADED' | 'ANALYZING' | 'PREVIEW_READY' | 'FINALIZING' | 'COMMITTED' | 'FAILED' | 'DELETED', required: Current transaction import lifecycle status
    - `undoRetryAvailable` boolean, required: Whether the import can enqueue or retry Undo from history
    - `updatedAt` string, date-time, required: Last import update timestamp
    - `walletAddress` string, required: Wallet address declared for import
  - `pagination` object, required
    - `pageSize` integer, required: Items returned per page.
    - `nextPageToken` string: Opaque token for retrieving the next page.

---

[API](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api.md) · [All operations](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/revisions/180622e6255e?raw)