---
title: "POST /v1/portfolios/{portfolioSlug}/adjustment-journal-imports/preview"
method: POST
path: "/v1/portfolios/{portfolioSlug}/adjustment-journal-imports/preview"
tags: ["AdjustmentJournalImports"]
---

# POST /v1/portfolios/{portfolioSlug}/adjustment-journal-imports/preview

`POST /v1/portfolios/{portfolioSlug}/adjustment-journal-imports/preview`

## 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}/adjustment-journal-imports/preview`
- Auth: API key in header `x-api-key`

## Path parameters

- `portfolioSlug` string, required

## Request body

- AdjustmentJournalImportPreviewRequestDto
  - `contentBase64` string, required: CSV or XLSX source file content as base64-encoded bytes (max 5 MiB).
  - `fileName` string, required: Original CSV or XLSX source filename.

## Response `201`

- AdjustmentJournalImportPreviewResponseDto
  - `baseCurrency` string, required
  - `candidates` union[], required
    - union
      - object
        - `accountNumber` string, required
        - `kind` 'account', required
        - `name` string, required
      - object
        - `externalId` string
        - `kind` 'counterparty', required
        - `name` string, required
      - object
        - `kind` 'responsibilityCenter', required
        - `name` string, required
        - `typeKey` string, required
        - `typeName` string, required
  - `entries` object[], required
    - `effectiveAt` string, required
    - `effectiveDate` string, required
    - `entryId` string, required
    - `lines` union[], required
      - union
        - object
          - `accountNumber` string, required
          - `amount` string, required
          - `counterparty` union
            - object
              - …
            - object
              - …
          - `effectiveAt` string, required
          - `effectiveDate` string, required
          - `entryId` string, required
          - `locator` union, required
            - object
              - …
            - object
              - …
          - `memo` string
          - `responsibilityCenters` object[], required
            - `dimensionKey` string, required
            - `value` string, required
          - `schemaVersion` 2, required
          - `sourceRowHash` string, required
          - `direction` 'DEBIT', required
        - object
          - `accountNumber` string, required
          - `amount` string, required
          - `counterparty` union
            - object
              - …
            - object
              - …
          - `effectiveAt` string, required
          - `effectiveDate` string, required
          - `entryId` string, required
          - `locator` union, required
            - object
              - …
            - object
              - …
          - `memo` string
          - `responsibilityCenters` object[], required
            - `dimensionKey` string, required
            - `value` string, required
          - `schemaVersion` 2, required
          - `sourceRowHash` string, required
          - `direction` 'CREDIT', required
    - `memo` string
  - `errors` union[], required
    - union
      - object
        - `code` 'ADJUSTMENT_JOURNAL_SOURCE_LAYOUT_INVALID' | 'ADJUSTMENT_JOURNAL_SOURCE_UNREADABLE', required
      - object
        - `code` 'ADJUSTMENT_JOURNAL_SOURCE_VALUE_INVALID' | 'ADJUSTMENT_JOURNAL_REQUIRED_VALUE_MISSING' | 'ADJUSTMENT_JOURNAL_EFFECTIVE_DATE_INVALID' | 'ADJUSTMENT_JOURNAL_AMOUNT_INVALID' | 'ADJUSTMENT_JOURNAL_DEBIT_CREDIT_INVALID' | 'ADJUSTMENT_JOURNAL_EFFECTIVE_TIMESTAMP_CONFLICT' | 'ADJUSTMENT_JOURNAL_MEMO_CONFLICT' | 'ADJUSTMENT_JOURNAL_DEBIT_MISSING' | 'ADJUSTMENT_JOURNAL_CREDIT_MISSING' | 'ADJUSTMENT_JOURNAL_UNBALANCED', required
        - `column` string
        - `entryId` string
        - `locator` union, required
          - object
            - `format` 'csv', required: Source file format.
            - `lineNumber` integer, required: 1-based line number in the CSV file.
          - object
            - `format` 'xlsx', required: Source file format.
            - `rowNumber` integer, required: 1-based row number within the sheet.
            - `sheetName` string, required: Worksheet the row belongs to.
      - object
        - `accountNumber` string, required
        - `code` 'ADJUSTMENT_JOURNAL_ACCOUNT_NOT_FOUND_OR_INELIGIBLE' | 'ADJUSTMENT_JOURNAL_ACCOUNT_AMBIGUOUS' | 'ADJUSTMENT_JOURNAL_ACCOUNT_BASE_CURRENCY_REQUIRED', required
        - `kind` 'account', required
        - `locator` union, required
          - object
            - `format` 'csv', required: Source file format.
            - `lineNumber` integer, required: 1-based line number in the CSV file.
          - object
            - `format` 'xlsx', required: Source file format.
            - `rowNumber` integer, required: 1-based row number within the sheet.
            - `sheetName` string, required: Worksheet the row belongs to.
      - object
        - `code` 'ADJUSTMENT_JOURNAL_COUNTERPARTY_NOT_FOUND_OR_INELIGIBLE' | 'ADJUSTMENT_JOURNAL_COUNTERPARTY_AMBIGUOUS', required
        - `kind` 'counterparty', required
        - `locator` union, required
          - object
            - `format` 'csv', required: Source file format.
            - `lineNumber` integer, required: 1-based line number in the CSV file.
          - object
            - `format` 'xlsx', required: Source file format.
            - `rowNumber` integer, required: 1-based row number within the sheet.
            - `sheetName` string, required: Worksheet the row belongs to.
        - `reference` union, required
          - object
            - `externalId` string, required
            - `kind` 'external-id', required
            - `name` string
          - object
            - `kind` 'name', required
            - `name` string, required
      - object
        - `code` 'ADJUSTMENT_JOURNAL_RESPONSIBILITY_CENTER_NOT_FOUND_OR_INELIGIBLE' | 'ADJUSTMENT_JOURNAL_RESPONSIBILITY_CENTER_AMBIGUOUS', required
        - `kind` 'responsibilityCenter', required
        - `locator` union, required
          - object
            - `format` 'csv', required: Source file format.
            - `lineNumber` integer, required: 1-based line number in the CSV file.
          - object
            - `format` 'xlsx', required: Source file format.
            - `rowNumber` integer, required: 1-based row number within the sheet.
            - `sheetName` string, required: Worksheet the row belongs to.
        - `name` string, required
        - `typeKey` string, required
  - `normalizedRows` union[], required
    - union
      - object
        - `accountNumber` string, required
        - `amount` string, required
        - `counterparty` union
          - object
            - `externalId` string, required
            - `kind` 'external-id', required
            - `name` string
          - object
            - `kind` 'name', required
            - `name` string, required
        - `effectiveAt` string, required
        - `effectiveDate` string, required
        - `entryId` string, required
        - `locator` union, required
          - object
            - `format` 'csv', required: Source file format.
            - `lineNumber` integer, required: 1-based line number in the CSV file.
          - object
            - `format` 'xlsx', required: Source file format.
            - `rowNumber` integer, required: 1-based row number within the sheet.
            - `sheetName` string, required: Worksheet the row belongs to.
        - `memo` string
        - `responsibilityCenters` object[], required
          - `dimensionKey` string, required
          - `value` string, required
        - `schemaVersion` 2, required
        - `sourceRowHash` string, required
        - `direction` 'DEBIT', required
      - object
        - `accountNumber` string, required
        - `amount` string, required
        - `counterparty` union
          - object
            - `externalId` string, required
            - `kind` 'external-id', required
            - `name` string
          - object
            - `kind` 'name', required
            - `name` string, required
        - `effectiveAt` string, required
        - `effectiveDate` string, required
        - `entryId` string, required
        - `locator` union, required
          - object
            - `format` 'csv', required: Source file format.
            - `lineNumber` integer, required: 1-based line number in the CSV file.
          - object
            - `format` 'xlsx', required: Source file format.
            - `rowNumber` integer, required: 1-based row number within the sheet.
            - `sheetName` string, required: Worksheet the row belongs to.
        - `memo` string
        - `responsibilityCenters` object[], required
          - `dimensionKey` string, required
          - `value` string, required
        - `schemaVersion` 2, required
        - `sourceRowHash` string, required
        - `direction` 'CREDIT', required
  - `previewHash` string, required
  - `referenceSnapshot` object, required
    - `accounts` object[], required
      - `accountNumber` string, required
    - `counterparties` union[], required
      - union
        - object
          - `externalId` string, required
          - `kind` 'external-id', required
          - `name` string
        - object
          - `kind` 'name', required
          - `name` string, required
    - `responsibilityCenters` object[], required
      - `dimensionKey` string, required
      - `name` string, required
  - `totals` object, required
    - `entryCount` integer, required
    - `rowCount` integer, required
    - `totalCredit` string, required: Precise signed decimal value encoded as a string.
    - `totalDebit` string, required: Precise signed decimal value encoded as a string.

---

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