API Phone Risk: Skor Risiko Nomor Telepon

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

Gunakan POST /v3/phone/risk/ saat Anda memerlukan intelijen telepon sebelum, sebagai pengganti, atau di luar alur OTP. Endpoint ini tidak mengirim kode ke pengguna. Endpoint ini membuat sesi API, memperkaya nomor tersebut, menerapkan aturan risiko telepon Anda, lalu mengembalikan blok telepon ternormalisasi yang sama dengan yang digunakan Verifikasi Telepon, dalam satu respons sinkron. Saat permintaan disimpan, Didit juga dapat menggunakan nomor telepon yang sudah dinilai sebagai bukti agregat di Networks. Grafik jaringan dapat menampilkan intelijen telepon berisiko tinggi, konteks porting dan jenis saluran pada sinyal telepon yang dibagikan, tetapi grafik tersebut tidak mengungkap nomor telepon mentah kepada organisasi lain.

Interpretasi respons

status adalah keputusan akhir untuk sesi API ini. Biasanya bernilai Approved; evaluasi risiko dapat menghasilkan In Review atau Declined.
phone.full_number adalah nomor E.164 yang sudah dinormalisasi. phone.phone_number_prefix dan phone.phone_number memisahkannya menjadi awalan internasional dan nomor nasional.
phone.is_disposable dan phone.is_virtual adalah sinyal ya/tidak yang stabil untuk logika aplikasi Anda. Pencarian operator menambahkan carrier.name dan carrier.type (mobile, voip, dan sejenisnya).
phone.phone_intelligence.score menggunakan skala risiko 0-100, di mana angka yang lebih tinggi berarti risiko yang lebih tinggi. phone_type_risk (Low, Medium, High) dan phone_trust_index (kebalikan dari skor) adalah tampilan turunan.
phone.phone_intelligence dan phone.enrichment adalah alias kompatibilitas dengan objek ternormalisasi yang sama. Integrasi baru dapat membaca phone.enrichment.
phone.matches mencantumkan sesi lain dari aplikasi Anda yang menggunakan nomor yang sama, tetapi oleh pengguna yang berbeda. Gunakan untuk deteksi akun duplikat.
request_id adalah id sesi API. Simpan bersama vendor_data jika Anda perlu mengaitkan hasil dengan webhook atau aktivitas konsol berikutnya.

phone.phone_intelligence dan phone.enrichment merupakan kolom dengan upaya terbaik. Pencarian yang sudah selesai dapat menghilangkan keduanya jika tidak ada data intelijen yang dapat digunakan untuk nomor, negara, atau paket tersebut. Bangun aturan berdasarkan kolom ternormalisasi yang stabil terlebih dahulu, dan perlakukan intelijen yang hilang sebagai “tidak diketahui”, bukan “aman”.

Pengaya jejak sosial

Atur enable_social ke true untuk menambahkan blok phone_social ke respons di bawah phone: platform daring tempat nomor telepon ini terdaftar, dikelompokkan berdasarkan kategori, beserta jumlah ringkasan dan detail profil apa pun yang dikembalikan mitra data kami.

phone.phone_social.profiles_registered dan phone.phone_social.profiles_checked adalah angka utama: platform tempat nomor telepon terkonfirmasi terdaftar, dari seluruh platform yang dievaluasi.
phone.phone_social.registered_platforms dan phone.phone_social.not_registered_platforms mencantumkan setiap platform beserta category dan scope-nya (global, atau local untuk platform khusus wilayah).
phone.phone_social.categories memberikan jumlah dan rasio terdaftar per kategori, sedangkan phone.phone_social.profiles memuat detail profil per platform jika platform tersebut menyediakannya (nama, URL foto, teks deskripsi, status privasi, dan penanda akun bisnis).
Indeks ringkasan (digital_footprint_diversity, digital_sophistication_index, engagement_depth_index, subscription_affordability_index) adalah komposit 0-10. Setiap jumlah dapat bernilai null jika pemeriksaan tidak mengembalikan data untuknya.

profiles_registered: 0 adalah jawaban yang valid, bukan kegagalan: platform-platform tersebut sudah diperiksa dan nomor telepon tidak ditemukan di satu pun dari mereka, yang merupakan sinyal umum identitas sintetis. Endpoint ini tidak mengambil tindakan atas hal tersebut dengan sendirinya. Gunakan phone_no_social_presence_action dalam alur kerja untuk mengubahnya menjadi keputusan Review atau Decline. Blok ini tidak ada jika enable_social tidak diatur, dan juga jika pemeriksaan jejak sosial tidak dapat diselesaikan. Dalam kasus terakhir, pemeriksaan jejak sosial tersebut tidak ditagih.

Perilaku Sandbox

Kunci sandbox memvalidasi permintaan dan mengembalikan data yang disetujui secara deterministik. Kunci tersebut tidak mengirim OTP, tidak menggunakan kredit, tidak membuat sesi, dan tidak berkontribusi ke Networks. Dengan enable_social diatur, kunci tersebut juga mengembalikan blok phone_social yang deterministik.

Penagihan

Panggilan Phone Risk API berharga $0.04 dengan harga daftar, lebih murah daripada Verifikasi Telepon penuh karena tidak ada OTP yang dikirim. Permintaan produksi dikenakan biaya begitu pencarian dimulai, meskipun beberapa kolom dengan upaya terbaik tidak tersedia. Pengaya jejak sosial ditagih secara terpisah: satu unit phone_social per permintaan, di atas harga Phone Risk API, setiap kali pemeriksaan selesai. Pemeriksaan kredit sebelum pencarian mencakup keduanya.

Otorisasi

x-api-key

string

header

wajib

Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.

Body

application/json

phone_number

string

wajib

Nomor telepon untuk dinilai. Nomor divalidasi dan dinormalisasi ke E.164.

Maximum string length: 20

Contoh:

"+14155552671"

country_code

string

Petunjuk negara ISO 3166-1 alpha-2 atau alpha-3 opsional untuk cakupan intelijen.

Maximum string length: 3

Contoh:

"US"

signals

object

Konteks perangkat dan jaringan opsional yang diamati oleh aplikasi Anda. Semua kolom bersifat opsional. Meneruskannya akan menyediakan data untuk deteksi kecocokan lintas sesi di Networks.

Show child attributes

vendor_data

string

Referensi stabil Anda untuk permintaan ini. Disimpan pada sesi API dan ditampilkan kembali dalam respons.

metadata

object | null

Metadata JSON non-sensitif Anda. Disimpan pada sesi API dan dikembalikan dalam respons.

Jika true, cari juga jejak sosial nomor tersebut - platform perpesanan, sosial, e-commerce, dan profesional tempat nomor tersebut terdaftar. Ditagih sebagai satu unit phone_social per permintaan selain harga endpoint ini sendiri.

Contoh:

true

Respons

Evaluasi risiko selesai. Periksa status untuk melihat keputusannya; HTTP selalu 200 untuk pencarian yang selesai.

request_id

string<uuid>

wajib

Id dari sesi API yang dibuat untuk permintaan ini. Simpan bersama vendor_data jika Anda perlu mengorelasikan hasilnya dengan webhook atau aktivitas konsol berikutnya.

status

enum<string>

wajib

Keputusan akhir untuk sesi API ini. Biasanya Approved; evaluasi risiko dapat menghasilkan In Review atau Declined.

Opsi yang tersedia:

Approved,

In Review,

Declined

created_at

string<date-time>

wajib

Cap waktu respons ini.

vendor_data

string | null

Salinan vendor_data yang Anda kirimkan, atau null jika Anda tidak mengirimkannya.

metadata

object | null

Salinan metadata yang Anda kirimkan, atau null jika Anda tidak mengirimkannya.

phone

object

Laporan telepon yang dinormalisasi, blok yang sama yang digunakan oleh respons Verifikasi Telepon.

Show child attributes

Terakhir diubah pada 7 November 2026

​Interpretasi respons

​Pengaya jejak sosial

​Perilaku Sandbox

​Penagihan

Otorisasi

Body

Respons

Interpretasi respons

Pengaya jejak sosial

Perilaku Sandbox

Penagihan