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"
}

फ़ोन सत्यापन

फ़ोन जोखिम API: कैरियर और धोखाधड़ी संकेत

Didit के साथ बिना OTP भेजे फ़ोन नंबर का जोखिम स्कोर पाएँ। एक सर्वर-से-सर्वर कॉल में कैरियर, लाइन प्रकार, पोर्टिंग, डिस्पोजेबल नंबर और धोखाधड़ी संकेत।

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"
}

जब आपको OTP प्रवाह से पहले, उसके बजाय, या उसके बाहर फ़ोन इंटेलिजेंस चाहिए, तब POST /v3/phone/risk/ का उपयोग करें। यह उपयोगकर्ता को कोई कोड नहीं भेजता। यह एक API सत्र बनाता है, नंबर को समृद्ध करता है, आपके फ़ोन-जोखिम नियम लागू करता है, और एक सिंक्रोनस प्रतिक्रिया में वही सामान्यीकृत फ़ोन ब्लॉक लौटाता है जो फ़ोन सत्यापन में उपयोग किया जाता है। जब अनुरोध सहेजा जाता है, तब Didit स्कोर किए गए फ़ोन नंबर को Networks में एकत्रित साक्ष्य के रूप में भी उपयोग कर सकता है। नेटवर्क ग्राफ़ साझा फ़ोन संकेतों पर उच्च-जोखिम वाली फ़ोन इंटेलिजेंस, पोर्टिंग और लाइन-प्रकार का संदर्भ दिखा सकते हैं, लेकिन वे अन्य संगठनों को कच्चा फ़ोन नंबर नहीं दिखाते।

प्रतिक्रिया की व्याख्या करें

status इस API सत्र का अंतिम निर्णय है। यह आमतौर पर Approved होता है। जोखिम मूल्यांकन In Review या Declined दे सकता है।
phone.full_number सामान्यीकृत E.164 नंबर है। phone.phone_number_prefix और phone.phone_number इसे अंतरराष्ट्रीय उपसर्ग और राष्ट्रीय नंबर में विभाजित करते हैं।
phone.is_disposable और phone.is_virtual एप्लिकेशन लॉजिक के लिए स्थिर हाँ/नहीं संकेत हैं। कैरियर लुकअप carrier.name और carrier.type (mobile, voip और इसी तरह के अन्य मान) जोड़ता है।
phone.phone_intelligence.score 0-100 के जोखिम पैमाने का उपयोग करता है, जहाँ अधिक संख्या का अर्थ अधिक जोखिम है। phone_type_risk (Low, Medium, High) और phone_trust_index (स्कोर का विलोम) व्युत्पन्न संकेतक हैं।
phone.phone_intelligence और phone.enrichment एक ही सामान्यीकृत ऑब्जेक्ट वाले संगतता उपनाम हैं। नए इंटीग्रेशन phone.enrichment पढ़ सकते हैं।
phone.matches आपके एप्लिकेशन के उन अन्य सत्रों की सूची देता है जिनमें यही नंबर किसी दूसरे उपयोगकर्ता ने इस्तेमाल किया। इसका उपयोग डुप्लिकेट खाता पहचान के लिए करें।
request_id API सत्र का ID है। यदि आपको परिणाम को बाद के webhook या कंसोल गतिविधि से मिलाना है, तो इसे vendor_data के साथ सहेजें।

phone.phone_intelligence और phone.enrichment सर्वोत्तम-प्रयास फ़ील्ड हैं। पूरा हुआ लुकअप दोनों को छोड़ सकता है, यदि उस नंबर, देश या प्लान के लिए कोई उपयोगी इंटेलिजेंस डेटा नहीं मिला। पहले स्थिर सामान्यीकृत फ़ील्ड पर नियम बनाएँ, और गायब इंटेलिजेंस को “अज्ञात” मानें, “सुरक्षित” नहीं।

सोशल फ़ुटप्रिंट ऐड-ऑन

phone के अंतर्गत प्रतिक्रिया में phone_social ब्लॉक जोड़ने के लिए enable_social को true पर सेट करें। इसमें वे ऑनलाइन प्लेटफ़ॉर्म होते हैं जिन पर यह फ़ोन नंबर पंजीकृत है, जिन्हें श्रेणी के अनुसार समूहित किया गया है, साथ में सारांश संख्याएँ और हमारे डेटा साझेदारों द्वारा लौटाए गए प्रोफ़ाइल विवरण।

phone.phone_social.profiles_registered और phone.phone_social.profiles_checked मुख्य संख्याएँ हैं: मूल्यांकन किए गए प्लेटफ़ॉर्मों में से वे प्लेटफ़ॉर्म जहाँ फ़ोन नंबर के पंजीकृत होने की पुष्टि हुई है, और मूल्यांकन किए गए प्लेटफ़ॉर्मों की कुल संख्या।
phone.phone_social.registered_platforms और phone.phone_social.not_registered_platforms हर प्लेटफ़ॉर्म को उसकी category और scope (global, या क्षेत्र-विशिष्ट प्लेटफ़ॉर्म के लिए local) के साथ सूचीबद्ध करते हैं।
phone.phone_social.categories प्रति श्रेणी पंजीकृत संख्या और अनुपात देता है, और जब कोई प्लेटफ़ॉर्म उन्हें उपलब्ध कराता है, तब phone.phone_social.profiles प्रति-प्लेटफ़ॉर्म प्रोफ़ाइल विवरण रखता है (नाम, फ़ोटो URL, परिचय टेक्स्ट, गोपनीयता स्थिति, व्यावसायिक-खाता फ़्लैग)।
सारांश सूचकांक (digital_footprint_diversity, digital_sophistication_index, engagement_depth_index, subscription_affordability_index) 0-10 के समग्र मान हैं। यदि जाँच ने किसी संख्या के लिए डेटा नहीं लौटाया, तो हर संख्या null हो सकती है।

profiles_registered: 0 एक वास्तविक उत्तर है, विफलता नहीं: प्लेटफ़ॉर्म की जाँच हुई और फ़ोन नंबर उनमें से किसी पर भी नहीं मिला, जो एक आम सिंथेटिक पहचान संकेत है। यह एंडपॉइंट इसके आधार पर अपने आप कोई कार्रवाई नहीं करता। इसे Review या Decline निर्णय में बदलने के लिए किसी वर्कफ़्लो में phone_no_social_presence_action का उपयोग करें। यदि enable_social सेट नहीं है, तो ब्लॉक अनुपस्थित रहता है। यह तब भी अनुपस्थित रहता है जब सोशल जाँच पूरी नहीं हो सकी, और ऐसी स्थिति में उसका बिल नहीं किया जाता।

सैंडबॉक्स व्यवहार

सैंडबॉक्स कुंजियाँ अनुरोध को मान्य करती हैं और निर्धारित रूप से स्वीकृत डेटा लौटाती हैं। वे OTP नहीं भेजतीं, क्रेडिट खर्च नहीं करतीं, सत्र नहीं बनातीं, और नेटवर्क में योगदान नहीं देतीं। enable_social सेट होने पर वे निर्धारित phone_social ब्लॉक भी लौटाती हैं।

बिलिंग

Phone Risk API कॉल की सूचीबद्ध कीमत $0.04 है, जो पूर्ण फ़ोन सत्यापन से कम है, क्योंकि इसमें OTP नहीं भेजा जाता। लाइव अनुरोध तब बिल योग्य हो जाता है जब लुकअप शुरू हो जाए, भले ही कुछ सर्वोत्तम-प्रयास फ़ील्ड उपलब्ध न हों। सोशल फ़ुटप्रिंट ऐड-ऑन का अलग से बिल होता है: जब भी जाँच पूरी होती है, Phone Risk API की कीमत के ऊपर प्रति अनुरोध एक phone_social यूनिट। लुकअप से पहले की क्रेडिट जाँच दोनों को कवर करती है।

प्राधिकरण

x-api-key

string

header

आवश्यक

आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys।

बॉडी

application/json

phone_number

string

आवश्यक

स्कोर करने के लिए फ़ोन नंबर। इसे मान्य किया जाता है और E.164 में सामान्यीकृत किया जाता है।

Maximum string length: 20

उदाहरण:

"+14155552671"

country_code

string

इंटेलिजेंस कवरेज के लिए वैकल्पिक ISO 3166-1 alpha-2 या alpha-3 देश संकेत।

Maximum string length: 3

उदाहरण:

"US"

signals

object

आपके एप्लिकेशन द्वारा देखा गया वैकल्पिक डिवाइस और नेटवर्क संदर्भ। सभी फ़ील्ड वैकल्पिक हैं। इन्हें पास करने से Networks में क्रॉस-सत्र मिलान डिटेक्शन को सहायता मिलती है।

Show child attributes

vendor_data

string

इस अनुरोध के लिए आपका स्थिर संदर्भ। API सत्र पर संग्रहीत और रिस्पॉन्स में लौटाया गया।

metadata

object | null

आपका गैर-संवेदनशील JSON मेटाडेटा। API सत्र पर संग्रहीत और रिस्पॉन्स में दोहराया गया।

true होने पर, नंबर के सोशल फ़ुटप्रिंट की भी खोज करें - मैसेजिंग, सोशल, ई-कॉमर्स और व्यावसायिक प्लेटफ़ॉर्म जिन पर यह पंजीकृत है। इस endpoint की अपनी कीमत के अतिरिक्त प्रति अनुरोध एक phone_social इकाई के रूप में बिल किया जाता है।

उदाहरण:

true

प्रतिक्रिया

जोखिम मूल्यांकन पूरा हो गया। निर्णय के लिए status का निरीक्षण करें; पूर्ण लुकअप के लिए HTTP हमेशा 200 होता है।

request_id

string<uuid>

आवश्यक

इस अनुरोध के लिए बनाए गए API सत्र की Id। यदि आपको बाद के webhook इवेंट या कंसोल गतिविधि के साथ परिणाम को सहसंबंधित करने की आवश्यकता है, तो इसे vendor_data के साथ संग्रहीत करें।

status

enum<string>

आवश्यक

इस API सत्र के लिए अंतिम निर्णय। आमतौर पर Approved; जोखिम मूल्यांकन In Review या Declined उत्पन्न कर सकता है।

उपलब्ध विकल्प:

Approved,

In Review,

Declined

created_at

string<date-time>

आवश्यक

इस रिस्पॉन्स का टाइमस्टैम्प।

vendor_data

string | null

आपके द्वारा भेजे गए vendor_data का इको, जब आपने इसे नहीं भेजा हो तो null।

metadata

object | null

आपके द्वारा भेजे गए metadata का इको, जब आपने इसे नहीं भेजा हो तो null।

phone

object

सामान्यीकृत फ़ोन रिपोर्ट, वही ब्लॉक जो फ़ोन सत्यापन रिस्पॉन्स द्वारा उपयोग किया जाता है।

Show child attributes

अंतिम संशोधन 7 नवंबर 2026

​प्रतिक्रिया की व्याख्या करें

​सोशल फ़ुटप्रिंट ऐड-ऑन

​सैंडबॉक्स व्यवहार

​बिलिंग

प्राधिकरण

बॉडी

प्रतिक्रिया

प्रतिक्रिया की व्याख्या करें

सोशल फ़ुटप्रिंट ऐड-ऑन

सैंडबॉक्स व्यवहार

बिलिंग