Fraud Check API Documentation

The RealValidation – Fraud Check API uses GET/POST methods and supports only HTTPS with TLS v1.2+. Determines if a phone number has possible fraudulent use, warranting further examination.

Required Input Parameters:

ParameterDescription
Phone10 numeric digits ONLY
TokenUnique PW given by RealValidation

Example API Call

https://api.realvalidation.com/rpvWebService/RealPhoneValidationFraudChk.php?phone=7275555555&token=1234ABCD-1234-ABCD-1234-123456ABCDEF

Result in XML

<?xml version=”1.0” encoding=”UTF-8”?>
<response>
<status>0</status>
<error_text></error_text>
<id>20</id>
<req_phone>7275555555</req_phone>
<tstatus>300</tstatus>
<tdesc>Transaction successfully completed</tdesc>
<phn_type>5</phn_type>
<phn_desc>VOIP</phn_desc>
<risk_level>medium</risk_level>
<recommendation>flag</recommendation>
<score>401</score>
<carrier>RingCentral - Sybase365</carrier>
<location_city>Countryside</location_city>
<location_state>FL</location_state>
<location_zip>34619</location_zip>
<location_metro_code></location_metro_code>
<location_county></location_county>
<location_country_name>United States</location_country_name>
<location_country_iso2>US</location_country_iso2>
<location_country_iso3>USA</location_country_iso3>
<location_latitude>27.99117</location_latitude>
<location_longitude>-82.72413</location_longitude>
<location_time_zone>America/New_York</location_time_zone>
<location_time_zone_utc_offset_min>-5</location_time_zone_utc_offset_min>
<location_time_zone_utc_offset_max>-5</location_time_zone_utc_offset_max>
<numbering_original_complete_phone_number>17275555555</numbering_original_complete_phone_number>
<numbering_original_country_code>1</numbering_original_country_code>
<numbering_original_phone_number>7275555555</numbering_original_phone_number>
<numbering_cleansing_call_country_code>1</numbering_cleansing_call_country_code>
<numbering_cleansing_call_phone_number>7275555555</numbering_cleansing_call_phone_number>
<numbering_cleansing_call_cleansed_code>100</numbering_cleansing_call_cleansed_code>
<numbering_cleansing_call_min_length>10</numbering_cleansing_call_min_length>
<numbering_cleansing_call_max_length>10</numbering_cleansing_call_max_length>
<numbering_cleansing_sms_country_code>1</numbering_cleansing_sms_country_code>
<numbering_cleansing_sms_phone_number>7275555555</numbering_cleansing_sms_phone_number>
<numbering_cleansing_sms_cleansed_code>100</numbering_cleansing_sms_cleansed_code>
<numbering_cleansing_sms_min_length>10</numbering_cleansing_sms_min_length>
<numbering_cleansing_sms_max_length>10</numbering_cleansing_sms_max_length>
</response>

Response Fields:

Response FieldDescription
Status(See appendix A below)
(See Appendix A below)(See Appendix A below)
IDinternal identifier
tstatus(See Appendix A below)
tdesc(See Appendix A below)
phn_type(See Appendix B below)
phn_desc(See Appendix B below)
risk level(See Appendix C below)
recommendation(See Appendix C below)
score(See Appendix C below)
carrierphone service provider
location_citygeographic city region that the phone number was originally assigned to
location_stategeographic state, province, territory, or district region that the phone number was originally assigned to
location_zipgeographic zip code region that the phone number was originally assigned to
location_metro_codegeographic Primary Metropolitan Statistical Area code that the phone number was originally assigned to
location_countygeographic U.S. county region that the phone number was originally assigned to
location_country_namegeographic country region that the phone number was originally assigned to
location_county_iso22 letter ISO abbreviation of the location_country
location_country_iso33 letter ISO abbreviation of the location_country
location_latitudegeographic latitude coordinates that the phone number was originally assigned to
location_longitude
location_longitudegeographic longitude coordinates that the phone number was originally assigned to
location_time_zonegeographic timezone name (U.S. Only) that the phone number was originally assigned to
location_time_zone_utc_offset_minthe location time zones minimum hour difference between UTC time
location_time_zone_utc_offset_maxthe location time zones maximum hour difference between UTC time
numbering_original_complete _phone_numberThe phone number complete with country code
numbering_original_ country_codeCountry code of phone number
numbering_original_ phone_numberThe complete phone number minus the country code
numbering_cleansing_ call_country_codepossibly corrected numeric country code needed to make the call
numbering_cleansing_ call_phone_numberpossibly corrected phone number to make the call
numbering_cleansing_ call_cleansed_codethe location time zone maximum hour difference between UTC time
numbering_cleansing_ call_min_lengthminimum number of phone digits allowed in this country for calling
numbering_cleansing_ call_max_lengthmaximum number of phone digits allowed in this country for calling
numbering_cleansing_ sms_country_codepossibly corrected numeric country code needed to send a text message
numbering_cleansing_ sms_phone_numberpossibly corrected phone number to send a text message
numbering_cleansing_ sms_cleansed_code(See Appendix D below)
numbering_cleansing_ sms_min_lengthminimum number of phone digits allowed in this country for sending a text message
numbering_cleansing_ sms_max_lengthmaximum number of phone digits allowed in this country for sending a text message

Appendix A:

tstatustdesc(description)
300Transaction successfully completedAble to obtain all applicable phone information
301Transaction partially completedUnable to obtain ALL of the phone information. This can cause some fields to return empty
500Transaction not attemptedPhone information collection was not attempted
501Phone number does not existContact support
599Contact support

Appendix B:

phn_typephn_desc(description)
1Fixed lineTypically, an 800 style number usually used for commercial purposes. Actual formatting will differ between countries
2MobileMobile / Cellular phone
3PrePaid MobileMobile phone that is not tied into a contract and has a potential chance for increased anonymity for the user
4Toll_FreeThe number belongs to non-call receiving pager device
5VoIPPhone that connects to its user over the internet and not directly through a telephony provider network
6PagerNumbers where tdesc is prefixed with Restricted typically have special uses or are reserved and cannot be tied to a civilian endpoint
7PayphoneTypical Payphone booth
8InvalidNot valid
9Restricted*The number is used for forwarding to any other number and is not tied to a particular location or device
10PersonalThe number belongs to a non-call-receiving pager device
11VoicemailNumbers designed only to connect straight to a voicemail account
20othera landline phone

Appendix C:

scorerisk levelrecommendationdescription
800-1000HighBlockDiscard number due to fraud use
601-800Medium-HighBlockDiscard number due to fraud use
401-600MediumFlagBe careful, as number is potentially used in fraud
201-400Medium-LowAllowNumber appears to be safe to use
0-200LowAllowNumber appears to be safe to use

Appendix D:

numbering_cleansing_call_cleansed_code -and-
numbering_cleansing_sms_cleansed_code
Description
100No changes were made as the formatting was correct
101Changed – Might have had extraneous digits removed or additional digits added to meet country dialing rules
102Phone was restricted and possibly used for premium or emergency services
103Phone number appears to be formatted correctly but could not be matched to a specific area
104Phone number is incorrectly formatted
105Phone length is either too long or too short
Fraud Check API Doc
Fraud Check API 060222

Before you go...

Are you currently using a
phone validation service?

Close
Scroll to Top