> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Networks

> Detect fraud rings automatically by clustering applicants sharing device, IP, face, document, phone, email, or address signals.

Networks automatically groups applicants, businesses, and transaction parties in your organization that share device, IP, biometric, document, or contact signals, so a ring of fraudulent accounts surfaces as one investigation instead of dozens of unrelated flags.

***

## What a network is

A network is a cluster of subjects (vendor users, vendor businesses, or transaction parties) connected through one or more shared signals. Didit builds networks continuously as verification sessions, business sessions, and transactions complete, clustering **organization-wide** across every application in your organization so a fraud ring that touches two of your products still surfaces as one network. Each application only sees the networks that include at least one of its own subjects.

<Note>
  Clustering runs on production data only. Sandbox applications are excluded entirely, sandbox sessions never create or join a network.
</Note>

## Signal types

A network forms when two or more subjects match on any of these signals:

<CardGroup cols={2}>
  <Card title="Exact device match" icon="fingerprint">
    The same device fingerprint appears across sessions.
  </Card>

  <Card title="Similar device match" icon="mobile">
    Device fingerprints similar enough to indicate the same physical device with minor variation.
  </Card>

  <Card title="Same IP address" icon="globe">
    Sessions or transactions originating from the same IP address.
  </Card>

  <Card title="Same physical address" icon="map-pin">
    Proof-of-address or registry data resolving to the same address.
  </Card>

  <Card title="Similar selfie backgrounds" icon="camera">
    Liveness captures sharing a visually similar background, a signal of a single operator running multiple sessions from one location.
  </Card>

  <Card title="Similar POA documents" icon="file-lines">
    Proof-of-address documents similar enough to indicate template reuse or a shared source document.
  </Card>
</CardGroup>

Three additional exact-match signals extend the same clustering without a dedicated design pattern yet:

| Signal                 | Trigger                                                      |
| ---------------------- | ------------------------------------------------------------ |
| Shared document number | The same ID document number appears on more than one subject |
| Shared phone number    | The same phone number appears on more than one subject       |
| Shared email address   | The same email address appears on more than one subject      |

<Note>
  Signal values are never stored or displayed in the clear. Every signal except the selfie-background and face-similarity signals is identified by a keyed hash of its normalized value, exact matches link subjects without Didit (or you) ever seeing the underlying device ID, IP, document number, phone, or email again.
</Note>

A signal that links an unusually large number of subjects (a shared office IP, a kiosk device, a data-center IP) is flagged as a **hub** rather than treated as automatic fraud evidence, hub signals are common in legitimate high-traffic settings and are surfaced for review, not auto-declined.

## Viewing a network

The **Networks** list is a table of every network visible to your application: network id, name, status, risk, the patterns and signals detected, and first/last activity, with the same status, signal, pattern, and risk-band filters as the API, plus free-text search by network name, member name, or network id.

Opening a network gives you four ways to explore it:

<CardGroup cols={2}>
  <Card title="Graph" icon="share-nodes">
    Subject and signal nodes connected by edges. Focus on one applicant and bound the view to 1, 2, or 3 hops to isolate their immediate connections instead of the whole network.
  </Card>

  <Card title="Table" icon="table">
    Every member as a row, with outcome status, risk, tags, and signal coverage, for scanning or exporting a large network.
  </Card>

  <Card title="Map" icon="map">
    Geographic points where members' addresses and locations converge, useful for spotting a ring anchored on one address or city.
  </Card>

  <Card title="Timeline" icon="clock">
    Chronological history of the network: when it was first detected, when each signal was observed, and every status change with its reason.
  </Card>
</CardGroup>

## Lifecycle

A network moves through exactly four statuses:

| Status      | Meaning                                                                                    |
| ----------- | ------------------------------------------------------------------------------------------ |
| `Active`    | Newly detected or still accumulating members, not yet reviewed                             |
| `In review` | An analyst is actively investigating                                                       |
| `Resolved`  | Investigation complete, the network was a legitimate cluster or the fraud has been handled |
| `Dismissed` | Reviewed and determined not to warrant action                                              |

Every status change is recorded with a reason and the acting analyst, forming the network's audit trail alongside its signal and detection history.

<Note>
  Network status describes the investigation, not any one member. Each member also carries its own **outcome status** inside the network (`Approved`, `In review`, `Declined`, `Not completed`), which is that applicant's own verification decision. A network can be `Active` while individual members are already `Approved` or `Declined`.
</Note>

## Acting on a network

From a network's detail page you can:

* **Create a case** to hand the network to your compliance team for a formal investigation, anchored to the network rather than a single subject.
* **Add to blocklist** a member's identity, or the signal itself, so future sessions matching it are automatically declined.
* **Change status** to move the network to In review, Resolved, or Dismissed, with a required reason.
* **Dismiss** a network in one step when it is clearly not fraud, this also closes out an active review if one is open.

## Related pages

<CardGroup cols={2}>
  <Card title="List networks" icon="list" href="/management-api/networks/list">
    Retrieve networks for your organization through the API.
  </Card>

  <Card title="Network membership lookup" icon="magnifying-glass" href="/management-api/networks/membership-lookup">
    Look up which networks a session, user, business, or transaction belongs to.
  </Card>

  <Card title="Blocklist users" icon="ban" href="/console/blocklist-users">
    How blocklisting a document, face, phone, or email affects future sessions.
  </Card>

  <Card title="Cases" icon="clipboard-check" href="/console/case-management/cases">
    Investigate a network case through to resolution.
  </Card>
</CardGroup>
