---
title: "Preview bulk intercompany pair candidates"
method: POST
path: "/v1/portfolio/{portfolioSlug}/portfolio-transactions/intercompany-bulk-pair-preview"
tags: ["PortfolioTransactions"]
---

# Preview bulk intercompany pair candidates

`POST /v1/portfolio/{portfolioSlug}/portfolio-transactions/intercompany-bulk-pair-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/portfolio/{portfolioSlug}/portfolio-transactions/intercompany-bulk-pair-preview`
- Auth: API key in header `x-api-key`

Finds unlinked expense and income transactions that can be converted into intercompany send and receive pairs without persisting changes.

## Path parameters

- `portfolioSlug` string, required

## Request body

- IntercompanyBulkPairPreviewRequestDto
  - `limit` integer

## Response `200`

Candidate pairs with proposed operation types, matcher evidence, and discovery status.

- IntercompanyBulkPairPreviewResponseDto
  - `result` object, required
    - `pairs` object[], required
      - `txId` string, required
      - `currentSide` 'SEND' | 'RECEIVE', required
      - `counterpartPortfolioSlug` string, required: Workspace-scoped counterpart portfolio slug
      - `counterpartPortfolioTransactionId` string, required
      - `treatment` 'CARRYOVER_BASIS_TRANSFER', required
      - `evidence` 'SAME_TX_HASH' | 'ASSET_AMOUNT_TIME', required
      - `source` object, required
        - `portfolioSlug` string, required: Workspace-scoped portfolio slug
        - `portfolioName` string, required
        - `portfolioTransactionId` string, required
        - `timestamp` string, date-time, required
        - `assetSummary` string, required
        - `amount` string, required
        - `currentOperationType` 'EXPENSE', required
        - `proposedOperationType` 'INTERCOMPANY_SEND', required
      - `destination` object, required
        - `portfolioSlug` string, required: Workspace-scoped portfolio slug
        - `portfolioName` string, required
        - `portfolioTransactionId` string, required
        - `timestamp` string, date-time, required
        - `assetSummary` string, required
        - `amount` string, required
        - `currentOperationType` 'INCOME', required
        - `proposedOperationType` 'INTERCOMPANY_RECEIVE', required
    - `discovery` object, required
      - `scannedRows` integer, required
      - `maxScannedRows` integer, required
      - `scanCompleted` boolean, required

---

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