---
title: "Merge a duplicate fraud network node into a survivor"
method: POST
path: "/api/admin/fraud_network/nodes/{heron_id}/merge"
tags: ["FraudNetwork"]
---

# Merge a duplicate fraud network node into a survivor

`POST /api/admin/fraud_network/nodes/{heron_id}/merge`

## Request

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

## Path parameters

- `heron_id` string, required

## Request body

- FraudNetworkNodeMergeSchema
  - `duplicate_heron_id` string, required

## Response `200`

Fraud network nodes merged

- FraudNetworkNodeSchema
  - `address_line_1` string, nullable
  - `address_line_2` string, nullable
  - `city` string, nullable
  - `company_name` string, nullable
  - `created` string, date-time
  - `created_by` string, nullable
  - `dba` string, nullable
  - `ein` string, nullable
  - `evidence` FraudNetworkEvidenceRead[]
    - `added_by` string
    - `audience` 'heron_internal' | 'disclosable'
    - `detail` object
    - `kind` 'detected_money_flow' | 'detected_funding' | 'customer_reported_fraud' | 'detected_shared_identifier' | 'detected_identity_details' | 'public_record' | 'staff_note' | 'reviewer_decision'
    - `note` string
    - `occurred_at` string, date-time, nullable
    - `refs` object
    - `retracted_at` string, date-time, nullable
    - `source` string
  - `heron_id` string
  - `internal_notes` string, nullable
  - `is_matchable` boolean
  - `last_updated` string, date-time
  - `network_heron_id` string, nullable
  - `network_name` string, nullable
  - `node_type` 'company' | 'person'
  - `owner_names` string[], nullable
  - `owner_ssns` string[], nullable
  - `reason_code` string, nullable
  - `source` string, nullable
  - `state` string, nullable
  - `validated_at` string, date-time, nullable
  - `validated_by` string, nullable
  - `zip` string, nullable

## Other responses

- `404`: Fraud network node not found
- `422`: Invalid fraud network node merge

## 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/:heron_id/merge/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)