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"}
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.phone.assess_risk(
phone_number="+14155552671",
)
print(result)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.PhoneAssessRiskParams{
Body: 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());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.phone.assess_risk(phone_number: "+14155552671")
puts result.to_husing 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"
}Phone Risk API: Carrier & Fraud Signals
Risk-score a phone number without sending an OTP. Carrier, line type, porting, disposable-number, and fraud signals in one server-to-server call.
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"}
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.phone.assess_risk(
phone_number="+14155552671",
)
print(result)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.PhoneAssessRiskParams{
Body: 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());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.phone.assess_risk(phone_number: "+14155552671")
puts result.to_husing 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 /v3/phone/risk/ when you need phone intelligence before, instead of, or outside an OTP flow.
It does not send a code to the user. It creates an API session, enriches the number, applies your phone-risk rules, and returns the same normalized phone block used by Phone Verification in one synchronous response.
When the request is saved, Didit can also use the scored phone number as aggregate evidence in Networks. Network graphs may show high-risk phone intelligence, porting and line-type context on shared phone signals, but they do not reveal the raw phone number to other organizations.
Interpret the response
statusis the final decision for this API session. It is normallyApproved; the risk evaluation can produceIn RevieworDeclined.phone.full_numberis the normalized E.164 number.phone.phone_number_prefixandphone.phone_numbersplit it into the international prefix and national number.phone.is_disposableandphone.is_virtualare the stable yes/no signals for application logic. The carrier lookup addscarrier.nameandcarrier.type(mobile,voip, and similar).phone.phone_intelligence.scoreuses a 0-100 risk scale where a higher number means higher risk.phone_type_risk(Low,Medium,High) andphone_trust_index(inverse of the score) are derived views.phone.phone_intelligenceandphone.enrichmentare compatibility aliases with the same normalized object. New integrations can readphone.enrichment.phone.matcheslists other sessions of your application where the same number was used by a different user. Use it for duplicate-account detection.request_idis the API session id. Store it withvendor_dataif you need to correlate the result with later webhooks or console activity.
phone.phone_intelligence and phone.enrichment are best-effort fields. A completed lookup can omit both when no usable intelligence data is returned for that number, country, or plan. Build rules on the stable normalized fields first and treat missing intelligence as “unknown”, not “safe”.Social footprint add-on
Setenable_social to true to add a phone_social block to the response under phone: the online platforms this phone number is registered on, grouped by category, with the summary counts and any profile details our data partners return.
phone.phone_social.profiles_registeredandphone.phone_social.profiles_checkedare the headline numbers: platforms where the phone number is confirmed registered, out of the platforms evaluated.phone.phone_social.registered_platformsandphone.phone_social.not_registered_platformslist each platform with itscategoryandscope(global, orlocalfor region-specific platforms).phone.phone_social.categoriesgives the registered count and ratio per category, andphone.phone_social.profilescarries per-platform profile details when a platform exposes them (name, photo URL, about text, privacy status, business-account flag).- Summary indexes (
digital_footprint_diversity,digital_sophistication_index,engagement_depth_index,subscription_affordability_index) are 0-10 composites. Every count can benullwhen the check returned no data for it.
profiles_registered: 0 is a real answer, not a failure: the platforms were checked and the phone number was found on none of them, which is a common synthetic-identity signal. This endpoint does not act on it by itself - use phone_no_social_presence_action in a workflow to turn it into a Review or Decline verdict.
The block is absent when enable_social is not set, and also when the social check could not be completed - in which case it is not billed.
Sandbox behavior
Sandbox keys validate the request and return deterministic approved data. They do not send an OTP, consume credits, create a session, or contribute to Networks. Withenable_social set, they also return a deterministic phone_social block.
Billing
Phone Risk API calls cost $0.04 at list price, less than full Phone Verification because no OTP is sent. A live request is billable once the lookup starts, even when some best-effort fields are unavailable. The social footprint add-on is billed separately: onephone_social unit per request on top of the Phone Risk API price, whenever the check completes. The credit check before the lookup covers both.Authorizations
Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is wrong, revoked or expired; 403 means no key was sent, the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.
Headers
Optional retry-safety key you choose for one operation, up to 255 characters (a UUID works). A request repeated with the same key, endpoint, query and body is answered with the first response, same status and same body, and runs and bills nothing a second time. The same key with another endpoint, query or body returns 409 idempotency_key_reused, and while the first request is still running, 409 idempotency_key_in_progress with Retry-After. A failed request (any 4xx or 5xx) is not stored, so you can send it again with the same key. Keys belong to your application, whether you call with an API key or an access token. See Retries and idempotency.
1 - 255Body
Response
The risk evaluation completed. Inspect status for the decision; HTTP is always 200 for completed lookups.