Global Phone Validation
Version 1.5
WSDL: http://ws.strikeiron.com/GlobalPhoneVal15?WSDL
Product Page: http://www.strikeiron.com/product-list/phone/phone-number-validation/
Description: Informatica’s Global Phone Validation service is a data validation and enrichment service for phone
numbers throughout the world across (### countries and territories). The primary benefits of Informatica’s Global
Phone Validation service are:




Global Phone Number Validation: In 200+ countries/territories and in near-real time
Identifies Phone Type: Identifies each phone number as landline, mobile, VoIP, or Freephone
Geocodes Coordinates: Geocodes each phone number using latitude and longitude
Offers Carrier Identification: Identifies a phone number’s carrier
Required License Information: The LicenseInfo parameter in our web services provides the authentication
credentials to allow the user to invoke the web service. Use the UserID and Password associated with your
StrikeIron account in the UserID and Password fields. Alternatively, you can also use your license key obtained from
StrikeIron with the password blank.
LicenseInfo Field: RegisteredUser Input
UserID:
Password:
Sample Input
[email protected]
Password1
License Subscription Information Output
LicenseStatusCode: This field returns a numeric code indicating
the StrikeIron license action taken as a result of invoking this operation
from the User ID and Password used for input. Valid license codes are 0, 1,
and 2. For example, a valid User ID and Password returns the code 0 with a
corresponding LicenseStatus value of Valid license key.
Sample Output
0
LicenseStatus: This field returns the status of the StrikeIron User ID
and Password corresponding to the LicenseStatusCode.
Valid license key
LicenseActionCode: This field returns a numeric code indicating the
StrikeIron license action taken as a result of invoking this operation.
GetRemainingHits returns the code 5 with a corresponding
LicenseAction value of Get remaining hits.
0
LicenseAction: This field returns the license action taken as a result
of invoking this operation from the User ID and Password used
corresponding to the LicenseActionCode.
Decremented hit count
RemainingHits: This field returns the number of hits against the
StrikeIron license key used when invoking this operation.
2
Amount: This field returns the number of hits used from the
StrikeIron User ID provided to invoke this operation.
0
Available Operations:
The available operations for Global Phone Validation are:










ValidateNumber
ValidateNumberCountryCode
ValidateNumberISO
ValidateNumberCountryName
GetAllCountries
GetCountryInfo
GetStatusCodesForMethod
GetStatusCodes
GetServiceInfo
GetRemainingHits
Operation: ValidateNumberCountryCode Input
Sample Input
Allows phone numbers to be validated based on passing a standard E.164 ITUT Country Code.
CountryCode: Integer based on E.164 ITU-T recommendations.
1-670 (equivalent of Northern
Mariana Islands); 47 (equivalent of
Norway), …
PhoneNumber: A single phone number, or a list of phone numbers
separated by commas. All phone numbers must include the country code.
1-919-467-4545
or
1-919-467-4545,1-809-222-3456
Note: Country Phone Codes should follow the conventions defined by the
ITU-T recommendations E.164
Operation: ValidateNumberCountryCode Output (Service Result)
Sample Output
The response object for ValidateNumberCountryCode Output (Service Result)
is the same response output as used by ValidateNumberOutput. Reference
ValidateNumberOutput
ValidateNumberOutput
Operation: ValidateNumberISO Input
Allows phone numbers to be validated based on passing an ISO-2 or ISO-3
Country Code specification.
Sample Input
CountryCode: String based on ISO-2 (2-character) or ISO-3 (3-character)
specification.
MP (equivalent of ISO-2 Northern
Mariana Islands); MNP (equivalent of
ISO-3 Northern Mariana Islands)
NO (equivalent of ISO-2 Norway);
NOR (equivalent of ISO-3 Norway);
PhoneNumber: A single phone number, or a list of phone numbers
separated by commas. All phone numbers must include the country code.
1-919-467-4545
or
1-919-467-4545,1-809-222-3456
Note: Country Phone Codes should follow the conventions defined by the
ITU-T recommendations E.164
Operation: ValidateNumberISO Output (Service Result)
Sample Output
The response object for ValidateNumberISO Output (Service Result) is the
same response output as used by ValidateNumberOutput. Reference
ValidateNumberOutput
ValidateNumberOutput
Operation: ValidateNumberCountryName Input
Sample Input
Allows phone numbers to be validated based on passing a standard ISO 31661 Country Name.
CountryName: String based on ISO 3166-1 specifications.
Northern Mariana Islands; Norway
PhoneNumber: A single phone number, or a list of phone numbers
separated by commas. All phone numbers must include the country code.
1-919-467-4545
or
1-919-467-4545,1-809-222-3456
Note: Country Phone Codes should follow the conventions defined by the
ITU-T recommendations E.164
Operation: ValidateNumberCountryName Output (Service Result)
Sample Output
The response object for ValidateNumberCountryName Output (Service Result) ValidateNumberOutput
is the same response output as used by ValidateNumberOutput. Reference
ValidateNumberOutput
Operation: GetAllCountries Input
Sample Input
Returns a listing of Country list used by Global Phone Validation 1.5 and E.164 (not input required)
ITU-T, ISO-2, ISO-3, ISO 3166-1 equivalents.
Operation: GetAllCountries Output (Method Result)
Sample Output
E.164 Country Code
578
ISO-2 Country Code
NO
ISO-3 Country Code
NOR
ISO 3166-1 Country Name
NORWAY
Operation: GetCountryInfo Input
Sample Input
String. Provides a listing of E.164 ITU-T, ISO-2, ISO-3, ISO 3166-1 country
code/name equivalent for a provided E.164 ITU-T, ISO-2, ISO-3, ISO 3166-1
country code/name.
NO
Operation: GetCountryInfo Output (Method Result)
Sample Output
Provides a listing of E.164 ITU-T, ISO-2, ISO-3, ISO 3166-1 country code/name 578, NO, NOR, NORWAY
equivalent for a provided E.164 ITU-T, ISO-2, ISO-3, ISO 3166-1 country
code/name.
Operation: ValidateNumber Input
Sample Input
PhoneNumber: A single phone number, or a list of phone numbers
separated by commas. All phone numbers must include the country code.
1-919-467-4545
or
1-919-467-4545,1-809-222-3456
Note: Country Phone Codes should follow the conventions defined by the
ITU-T recommendations E.164
Operation: ValidateNumber Output (ServiceResult)
Sample Output
Note: There will be one GlobalPhoneEntryWithStatus node per phone
number included in the ValidateNumber input.
Number: The number passed in without any decoration.
19194674545
CountryCode: International Telephone Union ITU-T Recommendation
E.164 numeric country code.
1
Commonly referred to as an International Dialing code, this code is the
combination of one, two or three digits identifying a specific country,
countries in an integrated numbering plan, or a specific geographic area.
InternationalPrefix: The digit, or combination of digits, that must be
dialed before a country code when dialing a call to a country other than
the one from which the call is being placed.
011
NationalPrefix: The digit, or combination of digits, which must be dialed
before an area (city) code when dialing a call to a subscriber from inside
his own country but outside his own numbering area.
1
CellPrefix: Dialing prefix that must prepend the National Significant Number for
inbound international calls to cellular and\or wireless numbers. This prefix
appears between the international Country Code and the National Destination
Code in normal dialing procedures.
9
NDC: National Destination Code (NDC) or significant leading digits of national
(significant) number. The NDC can be a decimal digit or a combination of decimal
digits (not including any prefix) identifying a numbering area within a country (or
group of countries included in one integrated numbering plan or a specific
geographic area) and/or
network/services.
919
Commonly referred to as an International City Code or (Numbering Plan) Area
Code, the NDC is a nationally optional code field, which – combined with the
Subscriber's Number (SN) – will constitute the national (significant) number of the
international E.164-number for geographic areas.
SN_From: Subscriber’s Number (SN) beginning range (low range) in this
block assignment.
4670000
In many numbering plans the subscriber number contains significant
leading digits that (in addition to the NDC) further define the local
exchange area and/or service. For example in the North American
Numbering Plan the first 3-digits of the subscriber number are known as
the Central Office Code or telephone exchange prefix and identify the
local (city) level service area.
SN_To: Subscriber’s Number (SN) ending range (high range) in this block
assignment.
4679999
Uses_NDC: True/false field indicating whether value specified in NDC
true
field is a National Destination Code (area code). If “N” NDCs are not used
in the country’s telephone numbering system however the leading digits
of a number can be used to determine number use and possible
geographic information.
Number_Type: Type of service associated with the particular
telephone exchange or number. Possible values are:
 LandLine
 VoIP
 Mobile
 Freephone
 Special
 Contaminated
LandLine
A Note on Number Portability: Global Phone Validation does
not track the change in Number_Type for phone numbers that
are ported from one carrier to another or converted from one
Number_Type to another (i.e., porting your home phone to a
mobile phone number).
CarrierName: Name of primary telecom carrier or service provider name
the numbering block is assigned to.
BELLSOUTH SO BELL
Language: ISO 639 language code identifying the predominate language
within the service area or territory.
en
Country: ISO 3166-1 numeric country code
840
ISO: ISO 3166-1 alpha 2 country code
US
RegionCode: Postal abbreviation or code of the state, province,
NC
department, territory, or similar division within the country associated with
the National Destination Code if any.
If a standard national abbreviation does not exist for the region the value
will be that specified in International Standard ISO 3166-2:2007 Codes for
the representation of names of countries and their subdivisions.
RegionName: Common name of the state, province, department, territory, North Carolina
or similar division, if any, identified by the National Destination Code and/or
National (Significant) Number.
When present, RegionName agrees with those values specified in the
International Standard ISO 3166-2:2007 Codes for the representation of
names of countries and their subdivisions.
City: Name of the geographic area, locale, city, municipality, or service type Cary
identified by the national (significant) number.
TimeZone: Time zone the service area is located in specified using Olson
Time Zone Database time zone ID.
America/New_York
UTC: Time zone specified as Coordinated Universal Time (UTC) offset.
Format is +/-hh:mm
-05:00
DST: True/false flag indicating whether daylight savings time is recognized
in this time zone.
true
Latitude: Latitude in decimal degree format of the locale, city, municipality, 35.79088408635926
or other geographically identifiable service area of the exchange.
Longitude: Longitude in decimal degree format of the locale, city,
municipality, or other geographically identifiable service area of the
exchange.
ErrorCode: Similar to the ItemStatus, this is a short text description of the
result for the number. Possible values are:





Operation: ValidateNumber Output (ServiceStatus)
StatusNbr: This field returns a number referring to the status of this
request. (See GetStatusCodes)
StatusDescription: This field returns the description of the status
number. (See GetStatusCodes)



NoError
NoError
NotFound
NDCNotFound
InvalidCountryCode
InvalidNumber
Operation: ValidateNumber Output (ItemStatus)
StatusNbr
StatusDescription
201
Valid Number
301
Number Not Found
302
NDC Not Found
303
Country Code Not Found
401
Invalid number
500
Internal Error



-78.78051611169455
Sample Output
Valid Number
Sample Output
200
BatchSuccess
"BatchSuccess" – success returned for all values checked
"Successful" – success returned for the single value requested
"BatchPartialSuccess" – success returned for some of the multiple
values checked
"BatchFailure" – all numbers requested in a multiple request failed
"Unsuccessful" – the single number requested was not found
"InternalError" – the program encountered an error
Operation: GetStatusCodesForMethod Input (ServiceResult)
MethodName: Input a method name to obtain a list of the Status
Codes for that method that display in the StatusNbr and StatusDescription
fields. Input options are: ValidateNumber, GetStatusCodesForMethod,
GetStatusCodes, GetServiceInfo, and GetRemainingHits. See
GetStatusCodes for possible return values.
Sample Input
ValidateNumber
Operation: GetStatusCodes Input
Note: The only input needed for this operation is the LicenseInfo
data. This operation displays a list of the Status Codes for the Web
service that display in the StatusNbr and StatusDescription fields.
Sample Input
(No input required)
Operation: GetStatusCodes Output (MethodStatusRecord)
MethodName: ValidateNumber
Sample Output
StatusNbr
StatusDescription
200
Successful
211
Data returned for all input numbers
212
Data returned for some input numbers
300
Unsuccessful
311
No data returned for input numbers
500
Internal Error
MethodName: GetStatusCodesForMethod
StatusNbr
StatusDescription
200
Found
300
Not Found
400
Invalid Method Name
500
Internal Error
MethodName: GetStatusCodes
StatusNbr
StatusDescription
200
Found
300
Not Found
500
Internal Error
MethodName: GetServiceInfo
StatusNbr
200
300
500
StatusDescription
Found
Not Found
Internal Error
Operation: GetServiceInfo Input
Note: The only input needed for this operation is the LicenseInfo
data. This operation displays the last time the Web service source data
was updated.
Sample Input
(No input required)
Operation: GetServiceInfo Output (ServiceStatus)
StatusNbr: This field returns a status number related to the
operation.
Sample Output
300
StatusDescription: This field returns a description of the status
number.
Not Found
Operation: GetRemainingHits Input
Note: The only input needed for this operation is the LicenseInfo
data. Its only return is the SubscriptionInfo which includes the Remaining
Hits.
Sample Input
(No input required)