---
title: "Add evidence to a fraud network node"
method: POST
path: "/api/admin/fraud_network/nodes/{heron_id}/evidence"
tags: ["FraudNetwork"]
---

# Add evidence to a fraud network node

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

## Request

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

## Path parameters

- `heron_id` string, required

## Request body

- FraudNetworkEvidenceCreate
  - `audience` 'heron_internal' | 'disclosable', required
  - `detail` object
  - `kind` 'detected_money_flow' | 'detected_funding' | 'customer_reported_fraud' | 'detected_shared_identifier' | 'detected_identity_details' | 'public_record' | 'staff_note' | 'reviewer_decision', required
  - `note` string, required
  - `occurred_at` string, date-time, nullable, required
  - `refs` object
  - `reporter_identified` boolean, required
  - `reporting_user_id` integer, nullable
  - `source` string, required
  - `source_ref` object, nullable

## Response `201`

Fraud network evidence created

- FraudNetworkEvidence
  - `added_by` string
  - `audience` 'heron_internal' | 'disclosable'
  - `created` string, date-time
  - `detail` object
  - `edge_heron_id` string, nullable
  - `heron_id` string
  - `kind` 'detected_money_flow' | 'detected_funding' | 'customer_reported_fraud' | 'detected_shared_identifier' | 'detected_identity_details' | 'public_record' | 'staff_note' | 'reviewer_decision'
  - `last_updated` string, date-time
  - `network_heron_id` string, nullable
  - `node_heron_id` string, nullable
  - `note` string
  - `occurred_at` string, date-time, nullable
  - `refs` object
  - `reporter_identified` boolean
  - `reporting_user_id` integer, nullable
  - `retracted_at` string, date-time, nullable
  - `retracted_by` string, nullable
  - `retraction_reason` string, nullable
  - `source` string
  - `source_ref` object, nullable

## Other responses

- `404`: Fraud network node or evidence reference not found
- `422`: Invalid fraud network evidence

## 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/evidence/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)