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

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

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

## 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/{importRef}`
- Auth: API key in header `x-api-key`

## Path parameters

- `importRef` string, required
- `portfolioSlug` string, required

## Response `200`

- TransactionImportSummaryDto
  - `auditPresentmentAvailable` boolean, required
  - `chainId` string, required
  - `commitResult` object, nullable, required
    - `committedAt` string, date-time, required
    - `importedCount` integer, required
    - `skippedCount` integer, required
  - `counts` object, required
    - `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
  - `declaredAddress` string, required
  - `declaredName` string, nullable
  - `failure` union
    - union
      - object
        - `category` 'PARSING', required
        - `code` 'TRANSACTION_IMPORT_SOURCE_AMOUNT_INVALID', required
        - `location` object
          - `column` string
          - `line` integer
          - `sheet` string
        - `message` 'An amount in the file is invalid. Use a non-zero fixed-point number with the supported precision.', required
      - object
        - `category` 'PARSING', required
        - `code` 'TRANSACTION_IMPORT_SOURCE_CURRENCY_INVALID', required
        - `location` object
          - `column` string
          - `line` integer
          - `sheet` string
        - `message` 'A currency in the file is not supported for that transaction type. Check the indicated row and column.', required
      - object
        - `category` 'PARSING', required
        - `code` 'TRANSACTION_IMPORT_SOURCE_DUPLICATE', required
        - `location` object
          - `column` string
          - `line` integer
          - `sheet` string
        - `message` 'The file contains a duplicate row or transaction. Remove the duplicate at the indicated row and retry.', required
      - object
        - `category` 'PARSING', required
        - `code` 'TRANSACTION_IMPORT_SOURCE_LAYOUT_INVALID', required
        - `location` object
          - `column` string
          - `line` integer
          - `sheet` string
        - `message` 'The file columns or worksheet layout do not match this integration. Export a fresh file from the provider and retry.', required
      - object
        - `category` 'PARSING', required
        - `code` 'TRANSACTION_IMPORT_SOURCE_TIMESTAMP_INVALID', required
        - `location` object
          - `column` string
          - `line` integer
          - `sheet` string
        - `message` 'A date or timestamp in the file is invalid. Check the indicated row and column.', required
      - object
        - `category` 'PARSING', required
        - `code` 'TRANSACTION_IMPORT_SOURCE_TYPE_UNSUPPORTED', required
        - `location` object
          - `column` string
          - `line` integer
          - `sheet` string
        - `message` 'A transaction type in the file is not supported. Check the indicated row and column.', required
      - object
        - `category` 'PARSING', required
        - `code` 'TRANSACTION_IMPORT_SOURCE_UNREADABLE', required
        - `location` object
          - `column` string
          - `line` integer
          - `sheet` string
        - `message` 'We could not read this file. Export it again as CSV or XLSX and retry.', required
      - object
        - `category` 'PARSING', required
        - `code` 'TRANSACTION_IMPORT_SOURCE_VALUE_INVALID', required
        - `location` object
          - `column` string
          - `line` integer
          - `sheet` string
        - `message` 'A value in the file is invalid. Check the indicated row and column.', required
    - object
      - `category` 'SYSTEM', required
      - `code` 'TRANSACTION_IMPORT_ANALYSIS_FAILED', required
      - `message` 'We could not process this import. Try again or contact support if the problem continues.', required
  - `importRef` string, required: Public transaction import reference
  - `status` 'UPLOADED' | 'ANALYZING' | 'PREVIEW_READY' | 'FINALIZING' | 'COMMITTED' | 'FAILED' | 'DELETED', required
  - `unresolvedGroups` object[], required
    - `id` string, required
    - `kind` 'TOKEN' | 'DECIMALS' | 'TIMEZONE', required
    - `message` string, required
    - `rowsAffected` integer
    - `suggestedDecimals` integer
    - `symbol` string
    - `tokenAddress` string
  - `updatedAt` string, date-time, required
  - `warnings` object[], required
    - `acknowledged` boolean, required
    - `id` string, required
    - `kind` string, required
    - `message` string, required
    - `rowsAffected` integer

---

[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/634c5114c75f?raw)