---
title: "Report"
method: POST
path: "/v0/scan/report"
tags: ["Report"]
---

# Report

`POST /v0/scan/report`

Report a misclassification of any entity (transaction, address, site, token, etc.) using a request ID from a previous scan.

## Request body

- GenericReportRequest
  - `event` 'FALSE_POSITIVE' | 'FALSE_NEGATIVE', required
  - `request_id` string, required — The request ID of a previous scan. This can be found in the value of the `x-request-id` field in the headers of the response of the previous request. For instance: `6c3cf6c1-a80d-4927-91b9-03d841ea61fe`.
  - `details` string, required — Details about the report.
  - `metadata` ScanRequestMetadata, required
    - `domain` string — The full URL of the DApp or website that initiated the request, for cross-reference. Must use the https or http scheme and contain a valid hostname. Cannot contain JSON, braces, or other embedded data structures.
    - `non_dapp` boolean — Set to true when the request was not initiated by a dapp. Dapp requests should provide the `domain` field.
    - `account` RoutersChainAgnosticModelsRequestAccount
      - `account_id` string, required — Unique identifier for the account.
      - `account_creation_timestamp` string, date-time — Timestamp when the account was created.
      - `user_age` integer — Age of the user in years
      - `user_country_code` string — ISO country code of the user's location.
      - `account_addresses` string[] — List of all account addresses in different chains based on the CAIPs standard (https://github.com/ChainAgnostic/CAIPs). Ethereum mainnet example: eip155:1:0xab16a96d359ec26a11e2c2b3d8f8b8942d5bfcdb
    - `connection` RoutersChainAgnosticModelsRequestConnection
      - `user_agent` string — User agent string from the client's browser or application.
      - `ip_address` string, ipvanyaddress, required — IP address of the customer making the request. Both IPv4 and IPv6 addresses are supported.
      - `origin` string, uri — The full URL of the website that the request was directed to.
      - `walletconnect_name` string — WalletConnect session name, when the request originates from a WalletConnect session.
      - `walletconnect_description` string — WalletConnect session description, when the request originates from a WalletConnect session.

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

> 95 revisions in range; 1 not diffed.

- **2026-06-24** `e5369ce49a48` — 1 breaking, 1 warning
  - added `#/components/schemas/ScanRequestMetadata` to the `metadata` request property `allOf` list
  - removed `#/components/schemas/ClientMetadata` from the `metadata` request property `allOf` list
- **2026-06-22** `631610b498db` — 4 info
  - added the new optional request property `metadata/allOf[subschema #1: ClientMetadata]/account/allOf[subschema #1: Account]/account_addresses`
  - added the new optional request property `metadata/allOf[subschema #1: ClientMetadata]/connection/allOf[subschema #1: Connection]/origin`
  - added the new optional request property `metadata/allOf[subschema #1: ClientMetadata]/connection/allOf[subschema #1: Connection]/walletconnect_description`
  - added the new optional request property `metadata/allOf[subschema #1: ClientMetadata]/connection/allOf[subschema #1: Connection]/walletconnect_name`
- **2026-05-13** `5863f4db314b` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2026-05-13** `d4ae5523be03` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/blockaid-official/apis/blockaid-api/changes/v0/scan/report/post.md)

---

[API](https://skmtc.dev/blockaid-official/apis/blockaid-api.md) · [All operations](https://skmtc.dev/blockaid-official/apis/blockaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blockaid-official/blockaid-api/revisions/e15b4bf2b25b/schema)