---
title: "Preview matches for a fraud network node"
method: POST
path: "/api/admin/fraud_network/nodes/dry_run"
tags: ["FraudNetwork"]
---

# Preview matches for a fraud network node

`POST /api/admin/fraud_network/nodes/dry_run`

## Request

- Base URL: `https://app.herondata.io`
- URL: `https://app.herondata.io/api/admin/fraud_network/nodes/dry_run`
- Auth: API key in header `x-api-key`

## Request body

- FraudNetworkNodeDryRunRequestSchema
  - `address_line_1` string, nullable
  - `address_line_2` string, nullable
  - `city` string, nullable
  - `company_name` string, nullable
  - `dba` string, nullable
  - `ein` string, nullable
  - `node_type` 'company' | 'person', required
  - `owner_names` string[], nullable
  - `owner_ssns` string[], nullable
  - `state` string, nullable
  - `window_days` integer
  - `zip` string, nullable

## Response `200`

Would-be matches for the candidate node

- FraudNetworkNodeDryRunResponseSchema
  - `matches` FraudNetworkNodeDryRunMatchSchema[]
    - `customer` string
    - `end_user_heron_id` string
    - `matched_field` string
    - `score` number
    - `submitted_value` string
  - `summary` FraudNetworkNodeDryRunSummarySchema
    - `deals_matched` integer
    - `distinct_customers` integer

## Other responses

- `422`: Invalid fraud network node dry run

## Changes

- **2026-11-03** `bd8008e49534`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/herondata/apis/heron-data-api/changes/api/admin/fraud_network/nodes/dry_run/post.md)

---

[API](https://skmtc.dev/herondata/apis/heron-data-api.md) - [All operations](https://skmtc.dev/herondata/apis/heron-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/herondata/apis/heron-data-api/revisions/1ec936e17fef?raw)