> ## 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. # API de graphe de réseau de fraude > Avec Didit, récupérez un réseau de fraude sous forme de graphe de nœuds sujets et signaux, avec un paramètre de profondeur pour borner le voisinage. Prompt de l'API du graphe de réseau Copier le prompt dans le presse-papiers \

\`Retrieve a fraud network as a graph through the Management API.

Endpoint:
GET https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/graph/

Authentication:
Use the x-api-key header with my Didit API key.

Path parameter:
\- network_uuid - the network's UUID.

Query params:
\- depth=1|2|3|all - hops from the focus subject to include. Defaults to all (unbounded).
\- focus_kind=vendor_user|vendor_business|transaction_party - must be supplied together with focus_id.
\- focus_id= - subject UUID to center the graph on.

Response 200: NetworkGraph - { network: NetworkDetail, depth: int|null, truncated: bool, nodes: [...], edges: [...], metrics: {node_count, edge_count, hub_signal_count} }.

Node shapes:
\- Subject node (kind: vendor_user | vendor_business | transaction_party): id, kind, subject, node_status (approved|in_review|declined|not_completed), tags.
\- Signal node (kind: signal): id, kind, uuid, signal_type, subject_count, coverage, is_hub, is_datacenter_ip, is_high_collision_device, node_status (signal_active|signal_guarded), tags, risk_evidence, first_seen_at, last_seen_at.

Edge shape: id, source (subject node id), target (signal node id), subject_kind, signal_type, confidence, observation_count, first_seen_at, last_seen_at.

Failure modes:
\- 404 - network not found or not visible.
\- 400 - depth is not one of 1, 2, 3, all, or focus_kind/focus_id supplied without the other.
\- 401/403 - auth/permission errors.

Side effects: none, pure read.

For the full integration shape, see /integration/integration-prompt.`

\
Coller dans Récupérez le réseau sous forme de graphe : des nœuds sujets pour chaque utilisateur du fournisseur, chaque entreprise du fournisseur ou chaque contrepartie de transaction du réseau, des nœuds de signal pour chaque valeur partagée d'appareil, d'IP, de visage, de numéro de document, de téléphone, d'e-mail ou d'adresse qui les relie, et des arêtes représentant les relations d'appartenance entre eux.Utilisez `depth` pour limiter le nombre de sauts à partir d'un sujet `focus_kind`/`focus_id` à renvoyer. C'est ce qui permet à la vue en graphe de la Console de se concentrer sur les connexions directes d'un candidat au lieu de charger l'intégralité du réseau. Omettez `depth` (ou transmettez `all`) pour obtenir le voisinage complet. `truncated` indique si une requête limitée a exclu des éléments.## Liens connexes- [Obtenir le réseau](https://docs.didit.me/fr/management-api/networks/get.md) - [Membres du réseau](https://docs.didit.me/fr/management-api/networks/members.md) - [Signaux du réseau](https://docs.didit.me/fr/management-api/networks/signals.md) ## OpenAPI ````yaml fr/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/graph/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/graph/: get: tags: - Networks summary: Obtenir le graphe du réseau description: >- Récupérer le réseau sous forme de graphe composé de nœuds représentant les sujets (utilisateurs du fournisseur, entreprises du fournisseur, parties à la transaction) et de nœuds de signaux (les valeurs partagées d'appareil/IP/visage/document/téléphone/e-mail/adresse qui les relient), avec des arêtes représentant les appartenances. operationId: get_network_graph parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID de l'organisation. - name: application_id in: path required: true schema: type: string format: uuid description: UUID de l'application. - name: network_uuid in: path required: true schema: type: string format: uuid example: n3a5e000-0000-4000-8000-000000000001 description: UUID du réseau. - name: depth in: query schema: type: string enum: - '1' - '2' - '3' - all description: >- Sauts à inclure à partir du sujet ciblé. Par défaut, tous (non limité). - name: focus_kind in: query schema: type: string enum: - vendor_user - vendor_business - transaction_party description: >- Type de sujet sur lequel centrer le graphe. Doit être fourni conjointement avec focus_id ; correspond par défaut à un membre arbitraire lorsque la profondeur est limitée et qu'aucun des deux n'est fourni. - name: focus_id in: query schema: type: string format: uuid description: UUID du sujet sur lequel centrer le graphe. responses: '200': description: Graphe de réseau. content: application/json: schema: $ref: '#/components/schemas/NetworkGraph' '404': description: Réseau non trouvé (ou non visible pour cette application). content: application/json: schema: type: object properties: detail: type: string security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/graph/?depth=2' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. client = Didit() result = client.networks.retrieve_graph( "n3a5e000-0000-4000-8000-000000000001", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. const didit = new Didit(); const result = await didit.networks.retrieveGraph("n3a5e000-0000-4000-8000-000000000001"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID\n// and DIDIT_APPLICATION_ID.\nclient := didit.NewClient()\n\nresult, err := client.Networks.RetrieveGraph(ctx, \"n3a5e000-0000-4000-8000-000000000001\", didit.NetworksRetrieveGraphParams{})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); var result = client.networks().retrieveGraph("n3a5e000-0000-4000-8000-000000000001"); System.out.println(result); - lang: php label: PHP source: >- networks->retrieveGraph('n3a5e000-0000-4000-8000-000000000001'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new result = didit.networks.retrieve_graph("n3a5e000-0000-4000-8000-000000000001") puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. using var client = new DiditClient(); var result = await client.Networks.RetrieveGraphAsync("n3a5e000-0000-4000-8000-000000000001"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: NetworkGraph: type: object properties: network: $ref: '#/components/schemas/NetworkDetail' depth: type: integer nullable: true description: >- Profondeur effective appliquée, ou null lorsqu'elle n'est pas restreinte (depth=all). truncated: type: boolean description: Vrai si le voisinage a été tronqué par la profondeur. nodes: type: array items: $ref: '#/components/schemas/NetworkGraphNode' edges: type: array items: $ref: '#/components/schemas/NetworkGraphEdge' metrics: type: object properties: node_count: type: integer edge_count: type: integer hub_signal_count: type: integer NetworkDetail: allOf: - $ref: '#/components/schemas/NetworkListItem' - type: object properties: stats: type: object description: >- Statistiques agrégées pour le réseau (par exemple totaux des membres). fraud_tags: type: array items: type: object description: Tags de schémas de fraude détectés sur le réseau. risk_signals: type: object description: >- Résumés des signaux de risque : residential_proxy_reuse, email_intelligence, phone_intelligence. reviewed_at: type: string format: date-time nullable: true reviewed_by: type: string nullable: true review_reason: type: string nullable: true properties: notes_count: type: integer minimum: 0 readOnly: true description: Nombre de notes privées d'analyste dans cette enquête. NetworkGraphNode: type: object description: >- Un nœud sujet ou un nœud signal, différencié par kind. Les nœuds sujets (kind: vendor_user | vendor_business | transaction_party) comportent id, kind, subject, node_status (approved | in_review | declined | not_completed) et tags. Les nœuds signaux (kind: signal) comportent id, kind, uuid, signal_type, subject_count, coverage, is_hub, is_datacenter_ip, is_high_collision_device, node_status (signal_active | signal_guarded), tags, risk_evidence, first_seen_at et last_seen_at. properties: id: type: string kind: type: string enum: - vendor_user - vendor_business - transaction_party - signal NetworkGraphEdge: type: object properties: id: type: string format: uuid source: type: string description: ID du nœud sujet. target: type: string description: ID du nœud de signal. subject_kind: type: string enum: - vendor_user - vendor_business - transaction_party signal_type: type: string enum: - ip_address - device - face - document_number - phone - email - address confidence: type: number format: float description: 1.0 pour une correspondance exacte. observation_count: type: integer first_seen_at: type: string format: date-time nullable: true last_seen_at: type: string format: date-time nullable: true NetworkListItem: type: object properties: uuid: type: string format: uuid network_id: type: string description: >- Identifiant séquentiel par organisation lisible par l'utilisateur, par exemple N-0001. name: type: string nullable: true status: type: string enum: - active - in_review - resolved - dismissed description: >- Statut du cycle de vie du réseau. Distinct de l'outcome_status par candidat au sein d'un réseau (approved/in_review/declined/not_completed). risk: $ref: '#/components/schemas/NetworkRiskDisplay' pattern_types: type: array items: type: string enum: - exact_same_device - similar_device - same_ip_address - same_address - similar_selfie_backgrounds - similar_poa_documents - same_document_number - same_phone_number - same_email description: Les modèles de regroupement détectés dans ce réseau. signal_types: type: array items: type: string enum: - ip_address - device - face - document_number - phone - email - address description: Les types de signaux distincts présents dans ce réseau. member_counts: type: object description: Nombre de membres par catégorie (par ex. total, par outcome_status). member_status: type: object description: Répartition des membres par outcome_status. signal_coverage: type: object description: Couverture par signal_type des membres de ce réseau. first_activity_at: type: string format: date-time nullable: true last_activity_at: type: string format: date-time nullable: true NetworkRiskDisplay: type: object properties: score: type: integer description: Score de risque, 0-100. band: type: string enum: - low - medium - high description: >- Catégorie dans laquelle le score s'affiche. high >= 70, medium >= 40, sinon low. bar: type: number format: float description: Valeur normalisée de 0 à 1 pour afficher une barre de risque. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.