Phone Social Insights
curl --request POST \
--url https://{environment-subdomain}.idmetagroup.com/api/v2/phone-social \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"country_code": "<string>",
"phone_number": "<string>",
"template_id": "{your_trust_flow_id}",
"verification_id": "{your_verification_id}"
}
'import requests
url = "https://{environment-subdomain}.idmetagroup.com/api/v2/phone-social"
payload = {
"country_code": "<string>",
"phone_number": "<string>",
"template_id": "{your_trust_flow_id}",
"verification_id": "{your_verification_id}"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
country_code: '<string>',
phone_number: '<string>',
template_id: '{your_trust_flow_id}',
verification_id: '{your_verification_id}'
})
};
fetch('https://{environment-subdomain}.idmetagroup.com/api/v2/phone-social', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{environment-subdomain}.idmetagroup.com/api/v2/phone-social",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'country_code' => '<string>',
'phone_number' => '<string>',
'template_id' => '{your_trust_flow_id}',
'verification_id' => '{your_verification_id}'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{environment-subdomain}.idmetagroup.com/api/v2/phone-social"
payload := strings.NewReader("{\n \"country_code\": \"<string>\",\n \"phone_number\": \"<string>\",\n \"template_id\": \"{your_trust_flow_id}\",\n \"verification_id\": \"{your_verification_id}\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{environment-subdomain}.idmetagroup.com/api/v2/phone-social")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"country_code\": \"<string>\",\n \"phone_number\": \"<string>\",\n \"template_id\": \"{your_trust_flow_id}\",\n \"verification_id\": \"{your_verification_id}\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{environment-subdomain}.idmetagroup.com/api/v2/phone-social")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"country_code\": \"<string>\",\n \"phone_number\": \"<string>\",\n \"template_id\": \"{your_trust_flow_id}\",\n \"verification_id\": \"{your_verification_id}\"\n}"
response = http.request(request)
puts response.read_body{
"status": "REJECTED",
"message": "OK",
"result": {
"code": "OK",
"message": "Success!",
"requestId": "93cac55d-224a-489a-b185-33ec511f5ff4",
"data": {
"id": "fp-f22c86c20ba44caebdc234c265496e31",
"createdAt": "2026-04-23T01:39:26Z",
"status": "COMPLETED",
"resultCode": "SUCCESS",
"resultMessage": null,
"requestMeta": {
"templateId": "tpl-ftp005002",
"mobileNumber": "60176415912",
"countryCode": "MY",
"footprintItemsTimeout": null,
"consent": {
"type": "IDmeta Phone Number & Email Footprint Consent",
"version": "v1",
"consentedAt": "2026-04-23T08:39:26Z",
"consentedWith": "By Starting",
"consentTemplateId": "ct-e09587eec0b548668e38bdf1a729952d"
}
},
"items": [
{
"name": "valid",
"value": "true",
"valueType": "BOOLEAN"
},
{
"name": "phoneType",
"value": null,
"valueType": "STRING"
},
{
"name": "disposable",
"value": "false",
"valueType": "BOOLEAN"
},
{
"name": "active",
"value": "false",
"valueType": "BOOLEAN"
},
{
"name": "originalCarrier",
"value": "MAXIS BROADBAND SDN BHD",
"valueType": "STRING"
},
{
"name": "carrier",
"value": "MAXIS BROADBAND SDN BHD",
"valueType": "STRING"
},
{
"name": "tenure",
"value": null,
"valueType": "NUMBER"
},
{
"name": "minTenure",
"value": null,
"valueType": "NUMBER"
},
{
"name": "maxTenure",
"value": null,
"valueType": "NUMBER"
},
{
"name": "phoneNumberAge",
"value": null,
"valueType": "STRING"
},
{
"name": "ported",
"value": "false",
"valueType": "STRING"
},
{
"name": "portedCount",
"value": "0",
"valueType": "STRING"
},
{
"name": "portedDaysSinceLast",
"value": null,
"valueType": "NUMBER"
},
{
"name": "registeredProfilesCount",
"value": "4",
"valueType": "NUMBER"
},
{
"name": "registeredEmailProviderProfilesCount",
"value": "0",
"valueType": "NUMBER"
},
{
"name": "registeredEcommerceProfilesCount",
"value": "0",
"valueType": "NUMBER"
},
{
"name": "registeredSocialMediaProfilesCount",
"value": "3",
"valueType": "NUMBER"
},
{
"name": "registeredProfessionalProfilesCount",
"value": "0",
"valueType": "NUMBER"
},
{
"name": "registeredMessagingProfilesCount",
"value": "1",
"valueType": "NUMBER"
},
{
"name": "socialMediaInstagramRegistered",
"value": "true",
"valueType": "BOOLEAN"
},
{
"name": "socialMediaFacebookRegistered",
"value": "false",
"valueType": "BOOLEAN"
},
{
"name": "lastActivity",
"value": null,
"valueType": "STRING"
},
{
"name": "numberOfNamesReturned",
"value": "0",
"valueType": "NUMBER"
},
{
"name": "numberOfPhotosReturned",
"value": "0",
"valueType": "NUMBER"
},
{
"name": "emailProviderGoogleRegistered",
"value": null,
"valueType": "BOOLEAN"
},
{
"name": "emailProviderGoogleName",
"value": null,
"valueType": "BOOLEAN"
},
{
"name": "emailProviderGoogleAccountId",
"value": null,
"valueType": "BOOLEAN"
},
{
"name": "ecommerceAmazonRegistered",
"value": "false",
"valueType": "BOOLEAN"
},
{
"name": "ecommerceBukalapakRegistered",
"value": null,
"valueType": "BOOLEAN"
},
{
"name": "ecommerceCarrefourRegistered",
"value": "false",
"valueType": "BOOLEAN"
},
{
"name": "socialMediaFacebookRegistered",
"value": "true",
"valueType": "BOOLEAN"
},
{
"name": "socialMediaTwitterRegistered",
"value": "true",
"valueType": "BOOLEAN"
},
{
"name": "professionalLinkedInRegistered",
"value": null,
"valueType": "BOOLEAN"
},
{
"name": "professionalMicrosoftRegistered",
"value": "false",
"valueType": "BOOLEAN"
},
{
"name": "messagingWhatsappRegistered",
"value": "true",
"valueType": "BOOLEAN"
},
{
"name": "messagingWhatsappPhoto",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingWhatsappPrivacyStatus",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingWhatsappLastSeen",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingWhatsappAbout",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingTelegramRegistered",
"value": null,
"valueType": "BOOLEAN"
},
{
"name": "messagingTelegramPhoto",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingTelegramPrivacyStatus",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingTelegramLastSeen",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeRegistered",
"value": null,
"valueType": "BOOLEAN"
},
{
"name": "messagingSkypeLanguage",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeGender",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeName",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeId",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeHandle",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeBio",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeAge",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeCity",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeState",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeCountry",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypePhoto",
"value": null,
"valueType": "STRING"
}
]
}
},
"risk_rating": "HIGH"
}Alternative Verifications
Phone Social Insights
Gather social and risk insights associated with a phone number.
POST
/
api
/
v2
/
phone-social
Phone Social Insights
curl --request POST \
--url https://{environment-subdomain}.idmetagroup.com/api/v2/phone-social \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"country_code": "<string>",
"phone_number": "<string>",
"template_id": "{your_trust_flow_id}",
"verification_id": "{your_verification_id}"
}
'import requests
url = "https://{environment-subdomain}.idmetagroup.com/api/v2/phone-social"
payload = {
"country_code": "<string>",
"phone_number": "<string>",
"template_id": "{your_trust_flow_id}",
"verification_id": "{your_verification_id}"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
country_code: '<string>',
phone_number: '<string>',
template_id: '{your_trust_flow_id}',
verification_id: '{your_verification_id}'
})
};
fetch('https://{environment-subdomain}.idmetagroup.com/api/v2/phone-social', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{environment-subdomain}.idmetagroup.com/api/v2/phone-social",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'country_code' => '<string>',
'phone_number' => '<string>',
'template_id' => '{your_trust_flow_id}',
'verification_id' => '{your_verification_id}'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{environment-subdomain}.idmetagroup.com/api/v2/phone-social"
payload := strings.NewReader("{\n \"country_code\": \"<string>\",\n \"phone_number\": \"<string>\",\n \"template_id\": \"{your_trust_flow_id}\",\n \"verification_id\": \"{your_verification_id}\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{environment-subdomain}.idmetagroup.com/api/v2/phone-social")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"country_code\": \"<string>\",\n \"phone_number\": \"<string>\",\n \"template_id\": \"{your_trust_flow_id}\",\n \"verification_id\": \"{your_verification_id}\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{environment-subdomain}.idmetagroup.com/api/v2/phone-social")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"country_code\": \"<string>\",\n \"phone_number\": \"<string>\",\n \"template_id\": \"{your_trust_flow_id}\",\n \"verification_id\": \"{your_verification_id}\"\n}"
response = http.request(request)
puts response.read_body{
"status": "REJECTED",
"message": "OK",
"result": {
"code": "OK",
"message": "Success!",
"requestId": "93cac55d-224a-489a-b185-33ec511f5ff4",
"data": {
"id": "fp-f22c86c20ba44caebdc234c265496e31",
"createdAt": "2026-04-23T01:39:26Z",
"status": "COMPLETED",
"resultCode": "SUCCESS",
"resultMessage": null,
"requestMeta": {
"templateId": "tpl-ftp005002",
"mobileNumber": "60176415912",
"countryCode": "MY",
"footprintItemsTimeout": null,
"consent": {
"type": "IDmeta Phone Number & Email Footprint Consent",
"version": "v1",
"consentedAt": "2026-04-23T08:39:26Z",
"consentedWith": "By Starting",
"consentTemplateId": "ct-e09587eec0b548668e38bdf1a729952d"
}
},
"items": [
{
"name": "valid",
"value": "true",
"valueType": "BOOLEAN"
},
{
"name": "phoneType",
"value": null,
"valueType": "STRING"
},
{
"name": "disposable",
"value": "false",
"valueType": "BOOLEAN"
},
{
"name": "active",
"value": "false",
"valueType": "BOOLEAN"
},
{
"name": "originalCarrier",
"value": "MAXIS BROADBAND SDN BHD",
"valueType": "STRING"
},
{
"name": "carrier",
"value": "MAXIS BROADBAND SDN BHD",
"valueType": "STRING"
},
{
"name": "tenure",
"value": null,
"valueType": "NUMBER"
},
{
"name": "minTenure",
"value": null,
"valueType": "NUMBER"
},
{
"name": "maxTenure",
"value": null,
"valueType": "NUMBER"
},
{
"name": "phoneNumberAge",
"value": null,
"valueType": "STRING"
},
{
"name": "ported",
"value": "false",
"valueType": "STRING"
},
{
"name": "portedCount",
"value": "0",
"valueType": "STRING"
},
{
"name": "portedDaysSinceLast",
"value": null,
"valueType": "NUMBER"
},
{
"name": "registeredProfilesCount",
"value": "4",
"valueType": "NUMBER"
},
{
"name": "registeredEmailProviderProfilesCount",
"value": "0",
"valueType": "NUMBER"
},
{
"name": "registeredEcommerceProfilesCount",
"value": "0",
"valueType": "NUMBER"
},
{
"name": "registeredSocialMediaProfilesCount",
"value": "3",
"valueType": "NUMBER"
},
{
"name": "registeredProfessionalProfilesCount",
"value": "0",
"valueType": "NUMBER"
},
{
"name": "registeredMessagingProfilesCount",
"value": "1",
"valueType": "NUMBER"
},
{
"name": "socialMediaInstagramRegistered",
"value": "true",
"valueType": "BOOLEAN"
},
{
"name": "socialMediaFacebookRegistered",
"value": "false",
"valueType": "BOOLEAN"
},
{
"name": "lastActivity",
"value": null,
"valueType": "STRING"
},
{
"name": "numberOfNamesReturned",
"value": "0",
"valueType": "NUMBER"
},
{
"name": "numberOfPhotosReturned",
"value": "0",
"valueType": "NUMBER"
},
{
"name": "emailProviderGoogleRegistered",
"value": null,
"valueType": "BOOLEAN"
},
{
"name": "emailProviderGoogleName",
"value": null,
"valueType": "BOOLEAN"
},
{
"name": "emailProviderGoogleAccountId",
"value": null,
"valueType": "BOOLEAN"
},
{
"name": "ecommerceAmazonRegistered",
"value": "false",
"valueType": "BOOLEAN"
},
{
"name": "ecommerceBukalapakRegistered",
"value": null,
"valueType": "BOOLEAN"
},
{
"name": "ecommerceCarrefourRegistered",
"value": "false",
"valueType": "BOOLEAN"
},
{
"name": "socialMediaFacebookRegistered",
"value": "true",
"valueType": "BOOLEAN"
},
{
"name": "socialMediaTwitterRegistered",
"value": "true",
"valueType": "BOOLEAN"
},
{
"name": "professionalLinkedInRegistered",
"value": null,
"valueType": "BOOLEAN"
},
{
"name": "professionalMicrosoftRegistered",
"value": "false",
"valueType": "BOOLEAN"
},
{
"name": "messagingWhatsappRegistered",
"value": "true",
"valueType": "BOOLEAN"
},
{
"name": "messagingWhatsappPhoto",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingWhatsappPrivacyStatus",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingWhatsappLastSeen",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingWhatsappAbout",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingTelegramRegistered",
"value": null,
"valueType": "BOOLEAN"
},
{
"name": "messagingTelegramPhoto",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingTelegramPrivacyStatus",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingTelegramLastSeen",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeRegistered",
"value": null,
"valueType": "BOOLEAN"
},
{
"name": "messagingSkypeLanguage",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeGender",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeName",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeId",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeHandle",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeBio",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeAge",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeCity",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeState",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypeCountry",
"value": null,
"valueType": "STRING"
},
{
"name": "messagingSkypePhoto",
"value": null,
"valueType": "STRING"
}
]
}
},
"risk_rating": "HIGH"
}Authorizations
Use Bearer {your_api_token} in the Authorization header.
Body
application/json
Country code of phone number for verification.
Phone number of individual for verification.
Identifier used to categorize or group requests for tracking or reporting.
A unique ID used to identify your verification request.