---
title: "Scan Post-Transaction"
method: POST
path: "/v0/sui/post-transaction/scan"
tags: ["Sui"]
---

# Scan Post-Transaction

`POST /v0/sui/post-transaction/scan`

Scan a transaction that was already executed on chain, returns validation with features indicating address poisoning entities and malicious operators.

## Request body

- SuiPostTransactionRequestSchema
  - `metadata` SuiPostTransactionRequestMetadata, required
    - `non_dapp` boolean, nullable — Indicates that the transaction was not initiated by a dapp. Use false when the transaction is from a dapp.
    - `domain` string, nullable — cross reference transaction against the domain.
  - `chain` 'mainnet', required
  - `options` SuiOptions[] — List of options to include in the response - `Options.validation`: Include Options.validation output in the response - `Options.simulation`: Include Options.simulation output in the response
  - `data` SuiPostTransactionRequestData, required
    - `tx_hash` string, required

## Response `200`

Successful Response

- SuiPostTransactionScanResponse
  - `simulation` union — Simulation result; Only present if simulation option is included in the request
    - SuiPostTransactionSimulationResult
      - `status` 'Success', required
      - `assets_diffs` object — Mapping between the address of an account to the assets diff during the transaction
      - `address_details` SuiAddressDetailsBaseSchemaSuiAddress[] — Details of addresses involved in the transaction
        - `account_address` string, required — Encoded public key of the account
        - `description` string, nullable — Description of the account
      - `account_summary` SuiAccountSummary, required
        - `account_assets_diffs` union[] — Assets diffs of the requested account address
          - union
            - SuiNativeAssetDiff
              - …
            - SuiNFTAssetDiff
              - …
            - SuiCoinsAssetDiff
              - …
        - `total_usd_diff` SuiTotalUsdDiffSchema, required
          - `in` number, required — Total incoming USD transfers
          - `out` number, required — Total outgoing USD transfers
          - `total` number — Total USD transfers
      - `params` SuiSimulationParams, required
        - `from` string, required
        - `value` string, required
        - `block_tag` string, required
        - `chain` string, required
    - SuiSimulationErrorSchema
      - `status` 'Error', required
      - `error` string, required — Error message
  - `validation` union
    - SuiValidationResult
      - `status` 'Success', required
      - `result_type` 'Benign' | 'Warning' | 'Malicious' | 'Error', required
      - `description` string, required — A textual description about the validation result
      - `reason` string, required — A textual description about the reasons the transaction was flagged with result_type
      - `classification` string, required — A textual classification that can be presented to the user explaining the reason.
      - `features` SuiValidationFeature[], required
        - `type` 'Benign' | 'Warning' | 'Malicious' | 'Info', required
        - `feature_id` string, required
        - `description` string, required — Textual description
        - `address` string, required — Address the feature refers to
    - SuiValidationErrorSchema
      - `status` 'Error', required
      - `error` string, required — Error message
  - `account_address` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/blockaid-official/apis/blockaid-api.md) · [All operations](https://skmtc.net/blockaid-official/apis/blockaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blockaid-official/blockaid-api/versions/17c41f337b2e/schema)