API Risque téléphonique : opérateur et signaux de fraude

curl

curl -X POST https://verification.didit.me/v3/phone/risk/ \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone_number": "+14155552671",
    "country_code": "US",
    "vendor_data": "lead-123",
    "metadata": {"source": "signup_prescreen"}
  }'

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

const result = await didit.phone.assessRisk({
  phone_number: "+14155552671",
});
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.Phone.AssessRisk(ctx, didit.PhoneRiskRequest{
	PhoneNumber: "+14155552671",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;
import me.didit.types.PhoneRiskRequest;

// Reads DIDIT_API_KEY.
Didit client = new Didit();

var result = client.phone().assessRisk(PhoneRiskRequest.builder()
        .phoneNumber("+14155552671")
        .build());
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->phone->assessRisk([
    'phone_number' => '+14155552671',
]);
print_r($result->toArray());

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.Phone.AssessRiskAsync(new PhoneRiskRequest
{
    PhoneNumber = "+14155552671",
});
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "request_id": "4fd09d2e-9bc9-4c4e-9c46-7f625ac0ab62",
  "status": "Approved",
  "phone": {
    "status": "Approved",
    "phone_number_prefix": "+1",
    "phone_number": "4155552671",
    "full_number": "+14155552671",
    "country_code": "US",
    "country_name": "United States",
    "carrier": {
      "name": "Example Mobile",
      "type": "mobile"
    },
    "is_disposable": false,
    "is_virtual": false,
    "verification_method": null,
    "verification_attempts": 0,
    "verified_at": null,
    "warnings": [],
    "lifecycle": [],
    "matches": [],
    "phone_intelligence": {
      "score": 3,
      "phone_type_risk": "Low",
      "phone_trust_index": 97,
      "network_stability_index": 95,
      "is_disposable": false,
      "is_ported": false,
      "is_recently_ported": false,
      "carrier_type": "mobile",
      "reason_codes": []
    },
    "enrichment": {
      "score": 3,
      "phone_type_risk": "Low",
      "phone_trust_index": 97,
      "network_stability_index": 95,
      "is_disposable": false,
      "is_ported": false,
      "is_recently_ported": false,
      "carrier_type": "mobile",
      "reason_codes": []
    }
  },
  "vendor_data": "lead-123",
  "metadata": {
    "source": "signup_prescreen"
  },
  "created_at": "2026-09-01T10:30:00.123456+00:00"
}

POST

phone

risk

curl

curl -X POST https://verification.didit.me/v3/phone/risk/ \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone_number": "+14155552671",
    "country_code": "US",
    "vendor_data": "lead-123",
    "metadata": {"source": "signup_prescreen"}
  }'

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

const result = await didit.phone.assessRisk({
  phone_number: "+14155552671",
});
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.Phone.AssessRisk(ctx, didit.PhoneRiskRequest{
	PhoneNumber: "+14155552671",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;
import me.didit.types.PhoneRiskRequest;

// Reads DIDIT_API_KEY.
Didit client = new Didit();

var result = client.phone().assessRisk(PhoneRiskRequest.builder()
        .phoneNumber("+14155552671")
        .build());
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->phone->assessRisk([
    'phone_number' => '+14155552671',
]);
print_r($result->toArray());

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.Phone.AssessRiskAsync(new PhoneRiskRequest
{
    PhoneNumber = "+14155552671",
});
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "request_id": "4fd09d2e-9bc9-4c4e-9c46-7f625ac0ab62",
  "status": "Approved",
  "phone": {
    "status": "Approved",
    "phone_number_prefix": "+1",
    "phone_number": "4155552671",
    "full_number": "+14155552671",
    "country_code": "US",
    "country_name": "United States",
    "carrier": {
      "name": "Example Mobile",
      "type": "mobile"
    },
    "is_disposable": false,
    "is_virtual": false,
    "verification_method": null,
    "verification_attempts": 0,
    "verified_at": null,
    "warnings": [],
    "lifecycle": [],
    "matches": [],
    "phone_intelligence": {
      "score": 3,
      "phone_type_risk": "Low",
      "phone_trust_index": 97,
      "network_stability_index": 95,
      "is_disposable": false,
      "is_ported": false,
      "is_recently_ported": false,
      "carrier_type": "mobile",
      "reason_codes": []
    },
    "enrichment": {
      "score": 3,
      "phone_type_risk": "Low",
      "phone_trust_index": 97,
      "network_stability_index": 95,
      "is_disposable": false,
      "is_ported": false,
      "is_recently_ported": false,
      "carrier_type": "mobile",
      "reason_codes": []
    }
  },
  "vendor_data": "lead-123",
  "metadata": {
    "source": "signup_prescreen"
  },
  "created_at": "2026-09-01T10:30:00.123456+00:00"
}

Utilisez POST /v3/phone/risk/ lorsque vous avez besoin d’informations sur le téléphone avant, à la place de, ou en dehors d’un flux OTP. Il n’envoie aucun code à l’utilisateur. Il crée une session API, enrichit le numéro, applique vos règles relatives au risque lié au téléphone, et renvoie dans une seule réponse synchrone le même bloc téléphone normalisé que celui utilisé par la Vérification du téléphone. Lorsque la requête est enregistrée, Didit peut également utiliser le numéro de téléphone évalué comme preuve agrégée dans Réseaux. Les graphes de réseau peuvent afficher une intelligence téléphonique à haut risque, ainsi que le contexte de portabilité et de type de ligne sur les signaux téléphoniques partagés, mais ils ne révèlent pas le numéro brut aux autres organisations.

Interpréter la réponse

status est la décision finale pour cette session API. Elle vaut généralement Approved ; l’évaluation du risque peut produire In Review ou Declined.
phone.full_number est le numéro normalisé au format E.164. phone.phone_number_prefix et phone.phone_number le décomposent en indicatif international et numéro national.
phone.is_disposable et phone.is_virtual sont des signaux oui/non stables pour la logique applicative. La recherche d’opérateur ajoute carrier.name et carrier.type (mobile, voip et valeurs similaires).
phone.phone_intelligence.score utilise une échelle de risque de 0 à 100, où une valeur plus élevée signifie un risque plus élevé. phone_type_risk (Low, Medium, High) et phone_trust_index (inverse du score) sont des vues dérivées.
phone.phone_intelligence et phone.enrichment sont des alias de compatibilité qui renvoient au même objet normalisé. Les nouvelles intégrations peuvent lire phone.enrichment.
phone.matches liste les autres sessions de votre application où le même numéro a été utilisé par un autre utilisateur. Utilisez-le pour détecter les comptes en double.
request_id est l’identifiant de la session API. Stockez-le avec vendor_data si vous devez corréler le résultat avec les webhooks ultérieurs ou l’activité de la console.

phone.phone_intelligence et phone.enrichment sont des champs disponibles dans la mesure du possible. Une recherche terminée peut omettre les deux lorsqu’aucune donnée d’intelligence exploitable n’est renvoyée pour ce numéro, ce pays ou ce forfait. Construisez d’abord vos règles sur les champs normalisés stables, et traitez des données d’intelligence manquantes comme « inconnues », et non comme « sûres ».

Module complémentaire d’empreinte sociale

Définissez enable_social sur true pour ajouter un bloc phone_social à la réponse, sous phone : les plateformes en ligne sur lesquelles ce numéro de téléphone est enregistré, regroupées par catégorie, avec les totaux récapitulatifs et les détails de profil éventuellement renvoyés par nos partenaires de données.

phone.phone_social.profiles_registered et phone.phone_social.profiles_checked sont les chiffres clés : les plateformes où le numéro est confirmé comme enregistré, sur le total des plateformes évaluées.
phone.phone_social.registered_platforms et phone.phone_social.not_registered_platforms listent chaque plateforme avec sa category et son scope (global, ou local pour les plateformes propres à une région).
phone.phone_social.categories donne le nombre enregistré et le ratio par catégorie, et phone.phone_social.profiles contient les détails de profil par plateforme lorsqu’une plateforme les expose (nom, URL de la photo, texte de présentation, statut de confidentialité, indicateur de compte professionnel).
Les indices de synthèse (digital_footprint_diversity, digital_sophistication_index, engagement_depth_index, subscription_affordability_index) sont des scores composites de 0 à 10. Chaque décompte peut être null lorsque la vérification n’a renvoyé aucune donnée correspondante.

profiles_registered: 0 est une réponse réelle, et non un échec : les plateformes ont été vérifiées et le numéro de téléphone n’a été trouvé sur aucune d’entre elles, ce qui constitue un signal courant d’identité synthétique. Cet endpoint n’agit pas sur ce point de lui-même : utilisez phone_no_social_presence_action dans un workflow pour le transformer en verdict Review ou Decline. Le bloc est absent lorsque enable_social n’est pas défini, et aussi lorsque la vérification sociale n’a pas pu être terminée, auquel cas elle n’est pas facturée.

Comportement en sandbox

Les clés sandbox valident la requête et renvoient des données approuvées déterministes. Elles n’envoient pas d’OTP, ne consomment pas de crédits, ne créent pas de session et ne contribuent pas à Réseaux. Avec enable_social défini, elles renvoient également un bloc phone_social déterministe.

Facturation

Les appels à l’API Phone Risk coûtent $0.04 au tarif public, soit moins que la Vérification du téléphone complète, car aucun OTP n’est envoyé. Une requête réelle est facturable dès que la recherche commence, même lorsque certains champs disponibles dans la mesure du possible sont indisponibles. Le module complémentaire d’empreinte sociale est facturé séparément : une unité phone_social par requête, en plus du prix de l’API Phone Risk, dès que la vérification est terminée. La vérification des crédits effectuée avant la recherche couvre les deux.

Autorisations

x-api-key

string

header

requis

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.

Corps

application/json

phone_number

string

requis

Numéro de téléphone à évaluer. Il est validé et normalisé au format E.164.

Maximum string length: 20

Exemple:

"+14155552671"

country_code

string

Indication de pays ISO 3166-1 alpha-2 ou alpha-3 optionnelle pour la couverture du renseignement.

Maximum string length: 3

Exemple:

"US"

signals

object

Contexte d'appareil et de réseau optionnel observé par votre application. Tous les champs sont optionnels. Les renseigner alimente la détection de correspondance inter-sessions dans Networks.

Show child attributes

vendor_data

string

Votre référence stable pour cette requête. Enregistrée sur la session API et renvoyée dans la réponse.

metadata

object | null

Vos métadonnées JSON non sensibles. Enregistrées sur la session d'API et renvoyées dans la réponse.

Si true, recherche également l'empreinte sociale du numéro : les plateformes de messagerie, sociales, d'e-commerce et professionnelles sur lesquelles il est enregistré. Facturé comme une unité phone_social par requête en plus du prix propre de cet endpoint.

Exemple:

true

Réponse

L'évaluation du risque est terminée. Inspectez status pour connaître la décision ; le code HTTP est toujours 200 pour les recherches terminées.

request_id

string<uuid>

requis

Identifiant de la session d'API créée pour cette requête. Enregistrez-le avec vendor_data si vous devez faire correspondre le résultat avec des webhooks ultérieurs ou l'activité de la console.

status

enum<string>

requis

Décision finale pour cette session d'API. Habituellement Approved ; l'évaluation des risques peut donner In Review ou Declined.

Options disponibles:

Approved,

In Review,

Declined

created_at

string<date-time>

requis

Horodatage de cette réponse.

vendor_data

string | null

Écho des vendor_data que vous avez envoyées, null si vous n'en avez pas envoyé.

metadata

object | null

Écho des metadata que vous avez envoyées, null si vous n'en avez pas envoyé.

phone

object

Rapport de téléphone normalisé, le même bloc que celui utilisé par les réponses de Vérification du téléphone.

Show child attributes

Dernière modification le 7 novembre 2026

​Interpréter la réponse

​Module complémentaire d’empreinte sociale

​Comportement en sandbox

​Facturation

Autorisations

Corps

Réponse

Interpréter la réponse

Module complémentaire d’empreinte sociale

Comportement en sandbox

Facturation