cloudmersive.validate
Module cloudmersive.validate
API
Definitions
ballerinax/cloudmersive.validate Ballerina library
Overview
The Cloudmersive Validate connector provides programmatic access to the Cloudmersive Validation API, which helps you validate and enrich data such as email addresses, domains, URLs, phone numbers, postal addresses, names, VAT numbers and IP addresses. This connector supports version 1 of the API and lets Ballerina applications call every validation operation through remote methods.
Key features
- Validate and normalize postal addresses, countries and geocodes
- Validate email addresses, domains, URLs and phone numbers
- Check IP addresses and URLs for threats, and geolocate IP addresses
- Detect SQL injection, XSS and XXE attacks in text input
- Parse names, user-agent strings, dates and VAT numbers
- Authenticate with a single Cloudmersive API key
Setup guide
To use this connector you need a Cloudmersive API key.
- Sign up or log in at the Cloudmersive portal.
- Open the API Keys page of your account.
- Create a new API key, or copy an existing one.
- Supply the key as the
apikeyfield when you initialize the client. Keep it out of source control, for example by reading it fromConfig.toml.
Quickstart
-
Add the import:
import ballerinax/cloudmersive.validate; -
Create a
Config.tomlwith your API key:apiKey = "<YOUR_API_KEY>" -
Declare the configurable for the API key:
configurable string apiKey = ?; -
Create the client and invoke an operation. Operations that take a plain string body expect a JSON string, so enclose the value in double-quotes:
public function main() returns error? { validate:Client validateClient = check new ({apikey: apiKey}); validate:CheckResponse _ = check validateClient->validateDomain("\"cloudmersive.com\""); }
Examples
The Cloudmersive Validate connector provides practical examples illustrating usage in various scenarios. Explore these examples, covering the following use cases:
- signup_data_validation - Validate the email address, full name and phone number from a sign-up form.
- request_threat_screening - Screen a web request by checking the client IP, referring URL and submitted text for threats.
Clients
cloudmersive.validate: Client
The validation APIs help you validate data. Check if an E-mail address is real. Check if a domain is real. Check up on an IP address, and even where it is located. All this and much more is available in the validation API.
Constructor
Gets invoked to initialize the connector.
init (ApiKeysConfig apiKeyConfig, ConnectionConfig config, string serviceUrl)- apiKeyConfig ApiKeysConfig - API keys for authorization
- config ConnectionConfig {} - The configurations to be used when initializing the
connector
- serviceUrl string "https://api.cloudmersive.com/validate" - URL of the target service
parseAddress
function parseAddress(ParseAddressRequest payload, map<string|string[]> headers) returns ParseAddressResponse|errorParse an unstructured input text string into an international, formatted address
Parameters
- payload ParseAddressRequest - Input parse request
Return Type
Deprecated
validateAddress
function validateAddress(ValidateAddressRequest payload, map<string|string[]> headers) returns ValidateAddressResponse|errorValidate a street address
Parameters
- payload ValidateAddressRequest - Input parse request
Return Type
normalizeAddress
function normalizeAddress(ValidateAddressRequest payload, map<string|string[]> headers) returns NormalizeAddressResponse|errorNormalize a street address
Parameters
- payload ValidateAddressRequest - Input parse request
Return Type
validateCity
function validateCity(ValidateCityRequest payload, map<string|string[]> headers) returns ValidateCityResponse|errorValidate a City and State/Province combination, get location information about it
Parameters
- payload ValidateCityRequest - Input parse request
Return Type
validateState
function validateState(ValidateStateRequest payload, map<string|string[]> headers) returns ValidateStateResponse|errorValidate a state or province, name or abbreviation, get location information about it
Parameters
- payload ValidateStateRequest - Input parse request
Return Type
validatePostalCode
function validatePostalCode(ValidatePostalCodeRequest payload, map<string|string[]> headers) returns ValidatePostalCodeResponse|errorValidate a postal code, get location information about it
Parameters
- payload ValidatePostalCodeRequest - Input parse request
Return Type
validateCountry
function validateCountry(ValidateCountryRequest payload, map<string|string[]> headers) returns ValidateCountryResponse|errorValidate and normalize country information, return ISO 3166-1 country codes and country name
Parameters
- payload ValidateCountryRequest - Input request
Return Type
listCountries
function listCountries(map<string|string[]> headers) returns CountryListResult|errorGet a list of ISO 3166-1 countries
Return Type
- CountryListResult|error - OK
checkEuMembership
function checkEuMembership(ValidateCountryRequest payload, map<string|string[]> headers) returns ValidateCountryResponse|errorCheck if a country is a member of the European Union (EU)
Parameters
- payload ValidateCountryRequest - Input request
Return Type
getCountryCurrency
function getCountryCurrency(ValidateCountryRequest payload, map<string|string[]> headers) returns ValidateCountryResponse|errorGet the currency of the input country
Parameters
- payload ValidateCountryRequest - Input request
Return Type
getCountryRegion
function getCountryRegion(ValidateCountryRequest payload, map<string|string[]> headers) returns ValidateCountryResponse|errorGet the region, subregion and continent of the country
Parameters
- payload ValidateCountryRequest - Input request
Return Type
getTimezones
function getTimezones(GetTimezonesRequest payload, map<string|string[]> headers) returns GetTimezonesResponse|errorGets IANA/Olsen time zones for a country
Parameters
- payload GetTimezonesRequest - Input request
Return Type
geocodeAddress
function geocodeAddress(ValidateAddressRequest payload, map<string|string[]> headers) returns ValidateAddressResponse|errorGeocode a street address into latitude and longitude
Parameters
- payload ValidateAddressRequest - Input parse request
Return Type
reverseGeocodeAddress
function reverseGeocodeAddress(ReverseGeocodeAddressRequest payload, map<string|string[]> headers) returns ReverseGeocodeAddressResponse|errorReverse geocode a lattitude and longitude into an address
Parameters
- payload ReverseGeocodeAddressRequest - Input reverse geocoding request
Return Type
getCurrentDateTime
function getCurrentDateTime(map<string|string[]> headers) returns DateTimeNowResult|errorGet current date and time as of now
Return Type
- DateTimeNowResult|error - OK
getPublicHolidays
function getPublicHolidays(GetPublicHolidaysRequest payload, map<string|string[]> headers) returns PublicHolidaysResponse|errorGet public holidays in the specified country and year
Parameters
- payload GetPublicHolidaysRequest - Input request
Return Type
parseStandardDateTime
function parseStandardDateTime(DateTimeStandardizedParseRequest payload, map<string|string[]> headers) returns DateTimeStandardizedParseResponse|errorParses a standardized date and time string into a date and time
Parameters
- payload DateTimeStandardizedParseRequest - Input request
Return Type
parseNaturalLanguageDateTime
function parseNaturalLanguageDateTime(DateTimeNaturalLanguageParseRequest payload, map<string|string[]> headers) returns DateTimeStandardizedParseResponse|errorParses a free-form natural language date and time string into a date and time
Parameters
- payload DateTimeNaturalLanguageParseRequest - Input request
Return Type
validateDomain
Validate a domain name
Parameters
- payload string - Domain name to check, for example "cloudmersive.com". The input is a string so be sure to enclose it in double-quotes
Return Type
- CheckResponse|error - OK
getDomainQualityScore
function getDomainQualityScore(string payload, map<string|string[]> headers) returns DomainQualityResponse|errorValidate a domain name's quality score
Parameters
- payload string - Domain name to check, for example "cloudmersive.com"
Return Type
getDomainWhois
Get WHOIS information for a domain
Parameters
- payload string - Domain name to check, for example "cloudmersive.com". The input is a string so be sure to enclose it in double-quotes
Return Type
- WhoisResponse|error - OK
validateUrlSyntax
function validateUrlSyntax(ValidateUrlRequestSyntaxOnly payload, map<string|string[]> headers) returns ValidateUrlResponseSyntaxOnly|errorValidate a URL syntactically
Parameters
- payload ValidateUrlRequestSyntaxOnly - Input URL information
Return Type
validateUrl
function validateUrl(ValidateUrlRequestFull payload, map<string|string[]> headers) returns ValidateUrlResponseFull|errorValidate a URL fully
Parameters
- payload ValidateUrlRequestFull - Input URL request
Return Type
getTopLevelDomain
function getTopLevelDomain(ValidateUrlRequestSyntaxOnly payload, map<string|string[]> headers) returns ValidateUrlResponseSyntaxOnly|errorGet top-level domain name from URL
Parameters
- payload ValidateUrlRequestSyntaxOnly - Input URL information
Return Type
checkUrlPhishing
function checkUrlPhishing(PhishingCheckRequest payload, map<string|string[]> headers) returns PhishingCheckResponse|errorCheck a URL for Phishing threats
Parameters
- payload PhishingCheckRequest - Input URL request
Return Type
checkAdminPath
function checkAdminPath(string payload, map<string|string[]> headers) returns IsAdminPathResponse|errorCheck if path is a high-risk or vulnerable server administration path
Parameters
- payload string - URL or relative path to check, e.g. "/admin/login". The input is a string so be sure to enclose it in double-quotes
Return Type
- IsAdminPathResponse|error - OK
checkUrlSafety
function checkUrlSafety(UrlSafetyCheckRequestFull payload, map<string|string[]> headers) returns UrlSafetyCheckResponseFull|errorCheck a URL for safety threats
Parameters
- payload UrlSafetyCheckRequestFull - Input URL request
Return Type
checkUrlSsrf
function checkUrlSsrf(UrlSsrfRequestFull payload, map<string|string[]> headers) returns UrlSsrfResponseFull|errorCheck a URL for SSRF threats
Parameters
- payload UrlSsrfRequestFull - Input URL request
Return Type
- UrlSsrfResponseFull|error - OK
checkUrlSsrfBatch
function checkUrlSsrfBatch(UrlSsrfRequestBatch payload, map<string|string[]> headers) returns UrlSsrfResponseBatch|errorCheck a URL for SSRF threats in batches
Parameters
- payload UrlSsrfRequestBatch - Input URL request as a batch of multiple URLs
Return Type
checkUrlHtmlSsrf
function checkUrlHtmlSsrf(UrlHtmlSsrfRequestFull payload, map<string|string[]> headers) returns UrlHtmlSsrfResponseFull|errorCheck a URL for HTML embedded SSRF threats
Parameters
- payload UrlHtmlSsrfRequestFull - Input URL request
Return Type
validateEmailSyntax
function validateEmailSyntax(string payload, map<string|string[]> headers) returns AddressVerifySyntaxOnlyResponse|errorValidate email adddress for syntactic correctness only
Parameters
- payload string - Email address to validate, e.g. "support@cloudmersive.com". The input is a string so be sure to enclose it in double-quotes
Return Type
checkEmailServers
function checkEmailServers(string payload, map<string|string[]> headers) returns AddressGetServersResponse|errorPartially check whether an email address is valid
Parameters
- payload string - Email address to validate, e.g. "support@cloudmersive.com". The input is a string so be sure to enclose it in double-quotes
Return Type
validateEmailFully
function validateEmailFully(string payload, map<string|string[]> headers) returns FullEmailValidationResponse|errorFully validate an email address
Parameters
- payload string - Email address to validate, e.g. "support@cloudmersive.com". The input is a string so be sure to enclose it in double-quotes
Return Type
getIpIntelligence
function getIpIntelligence(string payload, map<string|string[]> headers) returns IPIntelligenceResponse|errorGet intelligence on an IP address
Parameters
- payload string - IP address to process, e.g. "55.55.55.55". The input is a string so be sure to enclose it in double-quotes
Return Type
geolocateIp
Geolocate an IP address
Parameters
- payload string - IP address to geolocate, e.g. "55.55.55.55". The input is a string so be sure to enclose it in double-quotes
Return Type
- GeolocateResponse|error - OK
geolocateIpToStreetAddress
function geolocateIpToStreetAddress(string payload, map<string|string[]> headers) returns GeolocateStreetAddressResponse|errorGeolocate an IP address to a street address
Parameters
- payload string - IP address to geolocate, e.g. "55.55.55.55". The input is a string so be sure to enclose it in double-quotes
Return Type
checkIpThreat
Check if IP address is a known threat
Parameters
- payload string - IP address to check, e.g. "55.55.55.55". The input is a string so be sure to enclose it in double-quotes
Return Type
- IPThreatResponse|error - OK
checkIpTorNode
Check if IP address is a Tor node server
Parameters
- payload string - IP address to check, e.g. "55.55.55.55". The input is a string so be sure to enclose it in double-quotes
Return Type
- TorNodeResponse|error - OK
checkIpBot
Check if IP address is a Bot client
Parameters
- payload string - IP address to check, e.g. "55.55.55.55". The input is a string so be sure to enclose it in double-quotes
Return Type
- BotCheckResponse|error - OK
reverseLookupIp
function reverseLookupIp(string payload, map<string|string[]> headers) returns IPReverseDNSLookupResponse|errorPerform a reverse domain name (DNS) lookup on an IP address
Parameters
- payload string - IP address to check, e.g. "55.55.55.55". The input is a string so be sure to enclose it in double-quotes
Return Type
enrichLead
function enrichLead(LeadEnrichmentRequest payload, map<string|string[]> headers) returns LeadEnrichmentResponse|errorEnrich an input lead with additional fields of data
Parameters
- payload LeadEnrichmentRequest - Input lead with known fields set, and unknown fields left blank (null)
Return Type
getCompanyInformation
function getCompanyInformation(EmailLead payload, map<string|string[]> headers) returns LeadEnrichmentResponse|errorGet company information from email address
Parameters
- payload EmailLead - Input email address lead
Return Type
validateFullName
function validateFullName(FullNameValidationRequest payload, map<string|string[]> headers) returns FullNameValidationResponse|errorParse and validate a full name
Parameters
- payload FullNameValidationRequest - Validation request information
Return Type
validateFirstName
function validateFirstName(FirstNameValidationRequest payload, map<string|string[]> headers) returns FirstNameValidationResponse|errorValidate a first name
Parameters
- payload FirstNameValidationRequest - Validation request information
Return Type
validateLastName
function validateLastName(LastNameValidationRequest payload, map<string|string[]> headers) returns LastNameValidationResponse|errorValidate a last name
Parameters
- payload LastNameValidationRequest - Validation request information
Return Type
getGender
function getGender(GetGenderRequest payload, map<string|string[]> headers) returns GetGenderResponse|errorGet the gender of a first name
Parameters
- payload GetGenderRequest - Gender request information
Return Type
- GetGenderResponse|error - OK
validateIdentifier
function validateIdentifier(ValidateIdentifierRequest payload, map<string|string[]> headers) returns ValidateIdentifierResponse|errorValidate a code identifier
Parameters
- payload ValidateIdentifierRequest - Identifier validation request information
Return Type
validatePhoneNumber
function validatePhoneNumber(PhoneNumberValidateRequest payload, map<string|string[]> headers) returns PhoneNumberValidationResponse|errorValidate phone number (basic)
Parameters
- payload PhoneNumberValidateRequest - Phone number to validate in a PhoneNumberValidateRequest object. Try a phone number such as "1.800.463.3339", and either leave DefaultCountryCode blank or use "US"
Return Type
checkSqlInjection
function checkSqlInjection(string payload, CheckSqlInjectionHeaders headers) returns SqlInjectionDetectionResult|errorCheck text input for SQL Injection (SQLI) attacks
Parameters
- payload string - User-facing text input
- headers CheckSqlInjectionHeaders (default {}) - Headers to be sent with the request
Return Type
checkSqlInjectionBatch
function checkSqlInjectionBatch(SqlInjectionCheckBatchRequest payload, map<string|string[]> headers) returns SqlInjectionCheckBatchResponse|errorCheck and protect multiple text inputs for SQL Injection (SQLI) attacks in batch
Parameters
- payload SqlInjectionCheckBatchRequest - User-facing text input
Return Type
checkXss
Check text input for Cross-Site-Scripting (XSS) attacks
Parameters
- payload string - User-facing text input
Return Type
- XssProtectionResult|error - OK
protectXss
Protect text input from Cross-Site-Scripting (XSS) attacks through normalization
Parameters
- payload string - User-facing text input
Return Type
- XssProtectionResult|error - OK
checkXssBatch
function checkXssBatch(XssProtectionBatchRequest payload, map<string|string[]> headers) returns XssProtectionBatchResponse|errorCheck and protect multiple text inputs for Cross-Site-Scripting (XSS) attacks in batch
Parameters
- payload XssProtectionBatchRequest - User-facing text input
Return Type
checkHtmlSsrf
function checkHtmlSsrf(string payload, CheckHtmlSsrfHeaders headers) returns HtmlSsrfDetectionResult|errorProtect html input from Server-side Request Forgery (SSRF) attacks
Parameters
- payload string - User-facing HTML input
- headers CheckHtmlSsrfHeaders (default {}) - Headers to be sent with the request
Return Type
checkXxe
function checkXxe(string payload, CheckXxeHeaders headers) returns XxeDetectionResult|errorProtect text input from XML External Entity (XXE) attacks
Parameters
- payload string - User-facing text input
- headers CheckXxeHeaders (default {}) - Headers to be sent with the request
Return Type
- XxeDetectionResult|error - OK
checkXxeBatch
function checkXxeBatch(XxeDetectionBatchRequest payload, map<string|string[]> headers) returns XxeDetectionBatchResponse|errorProtect text input from XML External Entity (XXE) attacks
Parameters
- payload XxeDetectionBatchRequest - Batch of text inputs to scan for XXE attacks
Return Type
parseUserAgent
function parseUserAgent(UserAgentValidateRequest payload, map<string|string[]> headers) returns UserAgentValidateResponse|errorParse an HTTP User-Agent string, identify robots
Parameters
- payload UserAgentValidateRequest - Input parse request
Return Type
validateVat
function validateVat(VatLookupRequest payload, map<string|string[]> headers) returns VatLookupResponse|errorValidate a VAT number
Parameters
- payload VatLookupRequest - Input VAT code
Return Type
- VatLookupResponse|error - OK
Records
cloudmersive.validate: AddressGetServersResponse
Result of a partial email address validation
Fields
- servers? string[] - Email servers for this email address
- success? boolean - True if partial address validation was successufl, false otherwise
cloudmersive.validate: AddressVerifySyntaxOnlyResponse
Syntactic validity of email address
Fields
- validAddress? boolean - True if the email address is syntactically valid, false if it is not
- isFreeEmailProvider? boolean - True if the email domain name is a free provider (typically a free to sign up web email provider for consumers / personal use), false otherwise
- domain? string - Domain name of the email address
- isDisposable? boolean - True if the email address is a disposable email address, false otherwise; these disposable providers are not typically used to receive email and so will have a low likelihood of opening mail sent there
cloudmersive.validate: ApiKeysConfig
Provides API key configurations needed when communicating with a remote HTTP endpoint.
Fields
- apikey string - API Key Authentication
cloudmersive.validate: BotCheckResponse
Result of performing a Bot check on an IP address
Fields
- isBot? boolean - True if the input IP address is a Bot or Robot, false otherwise
cloudmersive.validate: CheckHtmlSsrfHeaders
Represents the Headers record for the operation: checkHtmlSsrf
Fields
- allowCidScheme? boolean - Optional: Set to true to allow cid: scheme URLs for email message attachments. Default is false
cloudmersive.validate: CheckResponse
Result of a validation operation
Fields
- validDomain? boolean - True if the domain name was valid, false if it is not
cloudmersive.validate: CheckSqlInjectionHeaders
Represents the Headers record for the operation: checkSqlInjection
Fields
- detectionLevel? string - Set to Normal to target a high-security SQL Injection detection level with a very low false positive rate; select High to target a very-high security SQL Injection detection level with higher false positives. Default is Normal (recommended)
cloudmersive.validate: CheckXxeHeaders
Represents the Headers record for the operation: checkXxe
Fields
- knownUnsafeUrls? string - Optional: Comma separated list of fully-qualified URLs that will automatically be considered unsafe
- knownSafeUrls? string - Optional: Comma separated list of fully-qualified URLs that will automatically be considered safe
- allowInternetUrls? boolean - Optional: Set to true to allow Internet-based dependency URLs for DTDs and other XML External Entitites, set to false to block. Default is false
cloudmersive.validate: ConnectionConfig
Provides a set of configurations for controlling the behaviours when communicating with a remote HTTP endpoint.
Fields
- httpVersion HttpVersion(default http:HTTP_2_0) - The HTTP version understood by the client
- http1Settings ClientHttp1Settings(default {}) - Configurations related to HTTP/1.x protocol
- http2Settings ClientHttp2Settings(default {}) - Configurations related to HTTP/2 protocol
- timeout decimal(default 30) - The maximum time to wait (in seconds) for a response before closing the connection
- forwarded string(default "disable") - The choice of setting
forwarded/x-forwardedheader
- followRedirects? FollowRedirects - Configurations associated with Redirection
- poolConfig? PoolConfiguration - Configurations associated with request pooling
- cache CacheConfig(default {}) - HTTP caching related configurations
- compression Compression(default http:COMPRESSION_AUTO) - Specifies the way of handling compression (
accept-encoding) header
- circuitBreaker? CircuitBreakerConfig - Configurations associated with the behaviour of the Circuit Breaker
- retryConfig? RetryConfig - Configurations associated with retrying
- cookieConfig? CookieConfig - Configurations associated with cookies
- responseLimits ResponseLimitConfigs(default {}) - Configurations associated with inbound response size limits
- secureSocket? ClientSecureSocket - SSL/TLS-related options
- proxy? ProxyConfig - Proxy server related options
- socketConfig ClientSocketConfig(default {}) - Provides settings related to client socket configuration
- validation boolean(default true) - Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
- laxDataBinding boolean(default true) - Enables relaxed data binding on the client side. When enabled,
nilvalues are treated as optional, and absent fields are handled asnilabletypes. Enabled by default.
cloudmersive.validate: CountryDetails
Details of one country
Fields
- subregion? string - Subregion in which the country is located; possible values are None, NorthernEurope, WesternEurope, SouthernEurope, EasternEurope, CentralAmerica, NorthernAmerica, SouthAmerica, EasternAfrica, MiddleAfrica, NorthernAfrica , SouthernAfrica , WesternAfrica , CentralAsia , EasternAsia , SouthernAsia , SouthEasternAsia , WesternAsia , Southern , Middle , AustraliaandNewZealand , Melanesia , Polynesia , Micronesia , Caribbean,
- iSOCurrencyCode? string - ISO 4217 currency three-letter code associated with the country
- countryName? string - Name of the country
- currencyEnglishName? string - Full name of the currency
- region? string - Region (continent) in which the country is located; possible values are None, Europe, Americas, Asia, Africa, Oceania
- threeLetterCode? string - Three-letter ISO 3166-1 country code
- iSOTwoLetterCode? string - Two-letter ISO 3166-1 country code
- isEuropeanUnionMember? boolean - True if this country is currently a member of the European Union (EU), false otherwise
- currencySymbol? string - Symbol associated with the currency
cloudmersive.validate: CountryListResult
Result of enumerating available countries
Fields
- countries? CountryDetails[] - List of current ISO 3166-1 countries in the world
- successful? boolean - True if the operation was successful, false otherwise
cloudmersive.validate: DateTimeNaturalLanguageParseRequest
Input parameter to a date time parsing request
Fields
- rawDateTimeInput? string - Raw string input of a natural language-formatted date and time for parsing
cloudmersive.validate: DateTimeNowResult
Current date and time response
Fields
- nowGmt? string - Current GMT-time-zone date, time, and time zone in standard JSON date format
- now? string - Current date, time, and time zone in standard JSON date format
- successful? boolean - True if successful, false otherwise
cloudmersive.validate: DateTimeStandardizedParseRequest
Input parameter to a date time parsing request
Fields
- rawDateTimeInput? string - Raw string input of a standard-formatted date and time for parsing
- countryCode? string - Optional: specify the two-letter country code to optimzie date formatting; default is US
cloudmersive.validate: DateTimeStandardizedParseResponse
Result of performing a date time parsing
Fields
- month? Signed32 - Month of the parsed date time result
- dayOfWeek? string - Day of week
- year? Signed32 - Year of the parsed date time result
- minute? Signed32 - Minute of the parsed date time result
- second? Signed32 - Second of the parsed date time result
- hour? Signed32 - Hour of the parsed date time result (24-hour)
- parsedDateResult? string - Result of performing a date time parsing
- successful? boolean - True if successful, false otherwise
- day? Signed32 - Day of the parsed date time result
cloudmersive.validate: DomainQualityResponse
Result of performing a domain quality score operation
Fields
- domainQualityScore? decimal - The quality score of the domain name; possible values are 0.0 to 10.0 with 10.0 being the highest and 0.0 being the lowest quality
cloudmersive.validate: EmailLead
Fields
- emailAddress? string -
cloudmersive.validate: FirstNameValidationRequest
Request to validate a first name
Fields
- firstName? string - First name to process
cloudmersive.validate: FirstNameValidationResponse
Result of a first name validation operation
Fields
- validationResult? string - Possible values are: ValidFirstName, ValidUnknownFirstName, InvalidSpamInput, InvalidCharacters, InvalidEmpty
- successful? boolean - True if the validation operation was successful, false otherwise
cloudmersive.validate: FullEmailValidationResponse
Full email addresss validation result
Fields
- validAddress? boolean - True if the email address is valid overall, false otherwise
- mailServerUsedForValidation? string - Email server connected to for verification
- validSyntax? boolean - True if the syntax of the email address is valid, false otherwise. This is one component of ValidAddress, but not the only one
- isCatchallDomain? boolean - True if the domain is a catch-all domain name, false otherwise. Catch-all domain names, while rare, always accept inbound email to ensure they do not lose any potentially useful emails. Catch-all domain names can occassionally be configured to first accept and store all inbound email, but then later send a bounce email back to the sender after a delayed period of time
- validSMTP? boolean - True if the email address was verified by the remote server, false otherwise. This is one component of ValidAddress, but not the only one
- validDomain? boolean - True if the domain name of the email address is valid, false otherwise. This is one component of ValidAddress, but not the only one
- isFreeEmailProvider? boolean - True if the email domain name is a free provider (typically a free to sign up web email provider for consumers / personal use), false otherwise
- domain? string - Domain name of the email address
- isDisposable? boolean - True if the email address is a disposable email address, false otherwise; these disposable providers are not typically used to receive email and so will have a low likelihood of opening mail sent there
cloudmersive.validate: FullNameValidationRequest
Request to validate a full name string
Fields
- fullNameString? string - Full name to process as a free-form string; supports many components such as First Name, Middle Name, Last Name, Title, Nickname, Suffix, and Display Name
cloudmersive.validate: FullNameValidationResponse
Result of a full name validation operation
Fields
- suffix? string - Suffix to the name, e.g. "Jr." or "Sr."
- validationResultLastName? string - Possible values are: ValidLastName, ValidUnknownLastName, InvalidSpamInput, InvalidCharacters, InvalidEmpty
- firstName? string - The first name (given name)
- validationResultFirstName? string - Possible values are: ValidFirstName, ValidUnknownFirstName, InvalidSpamInput, InvalidCharacters, InvalidEmpty
- displayName? string - The full display name of the name
- title? string - The person's title (if supplied), e.g. "Mr." or "Ms."
- lastName? string - The last name (surname)
- middleName? string - The middle name(s); if there are multiple names they will be separated by spaces
- nickName? string - Nickname (if supplied)
- successful? boolean - True if the validation operation was successful, false otherwise
cloudmersive.validate: GeolocateResponse
Geolocation result of performing an IP address geolocation operation. This product includes GeoLite2 data created by MaxMind, available from www.maxmind.com
Fields
- regionCode? string - State/region code of IP address
- countryName? string - Country name of IP address
- regionName? string - State/region of IP address
- zipCode? string - Zip or postal code of IP address
- timezoneStandardName? string - Timezone of IP address
- latitude? decimal - Latitude of IP address
- city? string - City of IP address
- countryCode? string - Two-letter country code of IP address
- longitude? decimal - Longitude of IP address
cloudmersive.validate: GeolocateStreetAddressResponse
Geolocation street address result
Fields
- streetAddress? string - Street address of IP address
- countryName? string - Country name of IP address
- regionName? string - State/region of IP address
- zipCode? string - Zip or postal code of IP address
- city? string - City of IP address
- countryCode? string - Two-letter country code of IP address
cloudmersive.validate: GetGenderRequest
Request to get the gender from a first name
Fields
- firstName? string - Input first name (given name) to get the gender of
- countryCode? string - Optional; the country for this name, possible values are "US", "LY", "NI", "TT", "MK", "KZ", "BO", "UG", "TZ", "CL", "SI", "MA", "RW", "VN", "AW", "CY", "BH", "SG", "ZA", "MU", "BR", "TN", "KH", "US", "TH", "TW", "UY", "DO", "CO", "UA", "QA", "BY", "SN", "SD", "FJ", "LB", "BE", "ML", "LV", "FR", "TM", "NG", "EC", "NO", "SL", "CR", "PA", "GE", "CH", "KR", "RS", "ZM", "FI", "BF", "MC", "AU", "GA", "LS", "RU", "IN", "SE", "LK", "BZ", "MX", "GH", "AF", "TJ", "BN", "DZ", "CM", "GR", "MD", "HN", "AT", "NZ", "SV", "GW", "NA", "AR", "MZ", "PK", "MN", "IQ", "BW", "VE", "PT", "BS", "AL", "TG", "ID", "ET", "CF", "JP", "BB", "PH", "CU", "BD", "AO", "SM", "LC", "ME", "RO", "ES", "EE", "IL", "ZW", "SY", "MW", "LU", "IR", "SC", "NL", "JO", "AM", "DE", "GL", "OM", "DK", "HR", "LI", "TD", "KM", "BA", "GM", "GD", "CA", "CZ", "MR", "ST", "IS", "LR", "IE", "VC", "AE", "KG", "DJ", "TR", "KE", "NE", "UZ", "CN", "GQ", "SK", "BJ", "MG", "BT", "EG", "PL", "IT", "SA", "MY", "CI", "AG", "AD", "KS", "HU", "CG", "KP", "DM", "GN", "GT", "NP", "JM", "LA", "GB", "BG", "HT", "PE", "AZ", "LT", "SZ", "PY", "MT", "VA"
cloudmersive.validate: GetGenderResponse
Result of the GetGender operation
Fields
- gender? string - Gender for this name; possible values are Male, Female, and Neutral (can be applied to Male or Female)
- successful? boolean - True if successful, false otherwise
cloudmersive.validate: GetPublicHolidaysRequest
Input parameter to a country validation request
Fields
- year? Signed32 - Optional - the year in which to retrieve the holidays; if left blank (0) it will default to the current year
- rawCountryInput? string - Two-letter code (FIPS 10-4 or ISO 3166-1) of the country; if not specified, defaults to United States
cloudmersive.validate: GetTimezonesRequest
Request to get time zones for a country
Fields
- countryCodeOrName? string - Can be the two-letter, three-letter country codes or country name
cloudmersive.validate: GetTimezonesResponse
Result of performing a get time zones operation
Fields
- fIPSTwoLetterCode? string - Two-letter FIPS 10-4 country code
- timezones? Timezone[] - Time zones (IANA/Olsen) in the country
- countryFullName? string - Full name of the country
- threeLetterCode? string - Three-letter ISO 3166-1 country code
- iSOTwoLetterCode? string - Two-letter ISO 3166-1 country code
- successful? boolean - True if successful, false otherwise
cloudmersive.validate: HtmlSsrfDetectionResult
Result of performing an XXE threat detection operation
Fields
- containedThreats? boolean - True if the input contained SSRF threats, false otherwise
- successful? boolean - True if the operation was successful, false otherwise
cloudmersive.validate: IPIntelligenceResponse
IP address intelligence result
Fields
- currencyCode? string - ISO 4217 currency code for the IP address location
- isTorNode? boolean - True if the IP address is a known Tor exit node, otherwise false
- regionArea? string - Region (continent) in which the country is located; possible values are None, Europe, Americas, Asia, Africa, Oceania
- isBot? boolean - True if the IP address is a known bot, otherwise false
- isEU? boolean - True if the IP address is in the European Union, otherwise false
- subregionArea? string - Subregion in which the country is located; possible values are None, NorthernEurope, WesternEurope, SouthernEurope, EasternEurope, CentralAmerica, NorthernAmerica, SouthAmerica, EasternAfrica, MiddleAfrica, NorthernAfrica , SouthernAfrica , WesternAfrica , CentralAsia , EasternAsia , SouthernAsia , SouthEasternAsia , WesternAsia , Southern , Middle , AustraliaandNewZealand , Melanesia , Polynesia , Micronesia , Caribbean,
- isThreat? boolean - True if the IP address is a known threat IP, otherwise false
- location? GeolocateResponse - Returns the location of the IP address
- currencyName? string - Name of the currency in English
cloudmersive.validate: IPReverseDNSLookupResponse
Result of performing a Reverse Domain (DNS) lookup on an IP address
Fields
- successful? boolean - True if a domain was found, false otherwise
- hostName? string - Host name (fully-qualified) associated with the IP address, if any
cloudmersive.validate: IPThreatResponse
Result of performing a IP threat check on an IP address
Fields
- threatType? string - Specifies the type of IP threat; possible values include Blocklist, Botnet, WebBot
- isThreat? boolean - True if the input IP address is a threat, false otherwise
cloudmersive.validate: IsAdminPathResponse
Result of performing an Admin Path operation
Fields
- isAdminPathNode? boolean - True if the input IP address is an Admin Path, and false otherwise
- successful? boolean - True if the operation was successful, false otherwise
cloudmersive.validate: LastNameValidationRequest
Request to validate a last name
Fields
- lastName? string - Last name to process
cloudmersive.validate: LastNameValidationResponse
Result of a last name validation operation
Fields
- validationResult? string - Possible values are: ValidLastName, ValidUnknownLastName, InvalidSpamInput, InvalidCharacters, InvalidEmpty
- successful? boolean - True if the validation operation was successful, false otherwise
cloudmersive.validate: LeadEnrichmentRequest
Input lead contact; fill in known fields to extend them with matched field values
Fields
- contactBusinessEmail? string - The person's business email address for the lead
- companyHouseNumber? string - House number of the address of the company for the lead
- companyDomainName? string - Domain name / website for the lead
- companyStreet? string - Street name of the address of the company for the lead
- contactLastName? string - The person's last name for the lead
- companyName? string - Name of the company for the lead
- companyPostalCode? string - Postal Code of the address of the company for the lead
- companyStateOrProvince? string - State or Province of the address of the company for the lead
- companyCountryCode? string - Country Code (2-letter ISO 3166-1) of the address of the company for the lead
- companyTelephone? string - Telephone of the company office for the lead
- companyVATNumber? string - VAT number of the company for the lead
- contactFirstName? string - The person's first name for the lead
- companyCity? string - City of the address of the company for the lead
- companyCountry? string - Country of the address of the company for the lead
cloudmersive.validate: LeadEnrichmentResponse
Result of the lead enrichment process
Fields
- contactBusinessEmail? string - The person's business email address for the lead
- companyHouseNumber? string - House number of the address of the company for the lead
- companyDomainName? string - Domain name / website for the lead
- employeeCount? Signed32 - Count of employees at the company (estimated), if available
- leadType? string - The type of the lead; possible types are Junk (a single individual using a disposable/throwaway email address); Individual (a single individual, typically a consumer, not purchasing on behalf of a business); SmallBusiness (a small business, typically with fewer than 100 employees); MediumBusiness (a medium business, larger than 100 employees but fewer than 1000 employees); Enterprise (a large business with greater than 1000 employees); Business (a business customer of unknown size)
- successful? boolean - True if the operation was successful, false otherwise
- companyStreet? string - Street name of the address of the company for the lead
- contactLastName? string - The person's last name for the lead
- companyName? string - Name of the company for the lead
- companyPostalCode? string - Postal Code of the address of the company for the lead
- companyStateOrProvince? string - State or Province of the address of the company for the lead
- companyCountryCode? string - Country Code (2-letter ISO 3166-1) of the address of the company for the lead
- companyTelephone? string - Telephone of the company office for the lead
- companyVATNumber? string - VAT number of the company for the lead
- contactFirstName? string - The person's first name for the lead
- contactGender? string - Gender for contact name; possible values are Male, Female, and Neutral (can be applied to Male or Female). Requires ContactFirstName
- companyCity? string - City of the address of the company for the lead
- companyCountry? string - Country Name of the address of the company for the lead
cloudmersive.validate: NormalizeAddressResponse
Result of validating a street address
Fields
- validAddress? boolean - True if the address is valid, false otherwise
- building? string - The name of the building, house or structure if applicable, such as "Cloudmersive Building 2". This will often by null
- stateOrProvince? string - The state or province of the address
- streetNumber? string - The street number or house number of the address. For example, in the address "1600 Pennsylvania Avenue NW" the street number would be "1600". This value will typically be populated for most addresses
- street? string - The name of the street or road of the address. For example, in the address "1600 Pennsylvania Avenue NW" the street number would be "Pennsylvania Avenue NW"
- postalCode? string - The postal code or zip code of the address
- countryFullName? string - Country of the address, if present in the address. If not included in the address it will be null
- latitude? decimal - If the address is valid, the degrees latitude of the validated address, null otherwise
- city? string - The city of the address
- iSOTwoLetterCode? string - Two-letter ISO 3166-1 country code
- longitude? decimal - If the address is valid, the degrees longitude of the validated address, null otherwise
cloudmersive.validate: ParseAddressRequest
Request to parse an address formatted as a string/free text into a structured address
Fields
- addressString? string - A mailing address or street address formatted as a single text string; this will be parsed into its components
- capitalizationMode? string - Optional; indicates how the parsed output should be capitalized; default is Title Case; possible values are: "Uppercase" will set the capitalization to UPPER CASE; "Lowercase" will set the capitalization to lower case; "Titlecase" will set the capitalization to Title Case; and "Originalcase" will preserve the original casing as much as possible
cloudmersive.validate: ParseAddressResponse
Result of parsing an address into its component parts
Fields
- building? string - The name of the building, house or structure if applicable, such as "Cloudmersive Building 2". This will often by null
- stateOrProvince? string - The state or province of the address
- streetNumber? string - The street number or house number of the address. For example, in the address "1600 Pennsylvania Avenue NW" the street number would be "1600". This value will typically be populated for most addresses
- street? string - The name of the street or road of the address. For example, in the address "1600 Pennsylvania Avenue NW" the street number would be "Pennsylvania Avenue NW"
- postalCode? string - The postal code or zip code of the address
- countryFullName? string - Country of the address, if present in the address. If not included in the address it will be null
- city? string - The city of the address
- iSOTwoLetterCode? string - Two-letter ISO 3166-1 country code
- successful? boolean - True if the parsing operation was successful, false otherwise
cloudmersive.validate: PhishingCheckRequest
Request to determine if a URL is a Phishing threat
Fields
- uRL? string - URL to validate
cloudmersive.validate: PhishingCheckResponse
Result of checking a URL for Phishing threats
Fields
- cleanURL? boolean - True if the URL is clean, false if it is at risk of containing a Phishing threat or attack
- threatType? string - Threat type of the Phishing threat; possible values are VerifiedPhishingURL, UnverifiedPhishingURL, or VerifiedPhishingDomain
cloudmersive.validate: PhoneNumberValidateRequest
Request to validate a phone number
Fields
- phoneNumber? string - Raw phone number string to parse as input for validation
- defaultCountryCode? string - Optional, default country code. If left blank, will default to "US"
cloudmersive.validate: PhoneNumberValidationResponse
Result from validating a phone number
Fields
- internationalFormat? string - Internaltional format of the phone number
- nationalFormat? string - National format of the phone number
- countryName? string - User-friendly long name of the country for the phone number
- e164Format? string - E.164 format of the phone number
- countryCode? string - Two digit country code of the phone number
- successful? boolean - True if the operation was successful, false if there was an error during validation. See IsValid for validation result
- phoneNumberType? string - Type of phone number; possible values are: FixedLine, Mobile, FixedLineOrMobile, TollFree, PremiumRate, SharedCost, Voip, PersonalNumber, Pager, Uan, Voicemail, Unknown
- isValid? boolean - True if the phone number is valid, false otherwise
cloudmersive.validate: PublicHolidayOccurrence
Public holiday occurrence
Fields
- holidayType? string - Type of the holiday; possible values are: Public, Optional
- occurrenceDate? string - Date of the holiday (start time)
- nationwide? boolean - True if the holiday is celebrated in all locales in the country, false otherwise
- englishName? string - Name of the holiday in English
- localName? string - Local name of the holiday
cloudmersive.validate: PublicHolidaysResponse
Result of performing a get public holidays request operation
Fields
- publicHolidays? PublicHolidayOccurrence[] - Public holidays in the requested country and year
- successful? boolean - True if successful, false otherwise
cloudmersive.validate: ReverseGeocodeAddressRequest
Request to reverse geocode a Street Address
Fields
- latitude? decimal - Latitude coordinate in WGS84 format
- longitude? decimal - Longitude coordinate in WGS84 format
cloudmersive.validate: ReverseGeocodeAddressResponse
Result of reverse geocoding a street address
Fields
- streetAddress? string - Street address to validate, such as '2950 Buskirk Ave.'
- stateOrProvince? string - State or province of the address to validate, such as 'CA' or 'California'
- postalCode? string - Zip code or postal code of the address to validate, such as '94597'
- countryFullName? string - Name of the country, such as 'United States'. Global countries are supported
- city? string - City part of the addrerss to validate, such as 'Walnut Creek'
- countryCode? string - Three-letter ISO 3166-1 country code
- successful? boolean - True if the address operation was successful, false otherwise
cloudmersive.validate: SqlInjectionCheckBatchRequest
Input to a batch SQL Injection detection operation
Fields
- requestItems? SqlInjectionCheckRequestItem[] - Multiple items to detect for SQL Injection
- detectionLevel? string - Set to Normal to target a high-security SQL Injection detection level with a very low false positive rate; select High to target a very-high security SQL Injection detection level with higher false positives. Default is Normal (recommended)
cloudmersive.validate: SqlInjectionCheckBatchResponse
Result of performing a batch XSS protection operation
Fields
- resultItems? SqlInjectionDetectionResult[] - Results from performing a batch SQL Injection detection operation; order is preserved from input data
cloudmersive.validate: SqlInjectionCheckRequestItem
Individual item to protect for SQL Injection
Fields
- inputText? string - Individual input text item to check for SQL Injection
cloudmersive.validate: SqlInjectionDetectionResult
Result of performing an SQL Injection protection operation
Fields
- containedSqlInjectionAttack? boolean - True if the input contained SQL Injection attacks, false otherwise
- successful? boolean - True if the operation was successful, false otherwise
- originalInput? string - Original input string
cloudmersive.validate: Timezone
IANA/Olsen time zone
Fields
- baseUTCOffset? string - UTC offset for this time zone
- now? string - The current time (Now) in this time zone
- name? string - Name of the Time Zone
cloudmersive.validate: TorNodeResponse
Result of performing a Tor node check on an IP address
Fields
- isTorNode? boolean - True if the input IP address is a Tor exit node, false otherwise
cloudmersive.validate: UrlHtmlSsrfRequestFull
Request to determine if a URL contains HTML-embedded SSRF threats
Fields
- uRL? string - URL to validate
cloudmersive.validate: UrlHtmlSsrfResponseFull
Result of checking a URL for HTML-embedded SSRF threats
Fields
- cleanURL? boolean - True if the URL is clean, false if it is at risk of containing an SSRF threat or attack
- httpResponseCode? Signed32 - HTTP response code from the URL
cloudmersive.validate: UrlSafetyCheckRequestFull
Request to determine if a URL is a safety threat check
Fields
- uRL? string - URL to validate
cloudmersive.validate: UrlSafetyCheckResponseFull
Result of checking a URL for safety threats
Fields
- cleanURL? boolean - True if the URL is clean, false if it is at risk of containing a safety threat or attack
- threatType? string - Threat type identified, if any; possible values are "ForcedDownload", "VirusesAndMalware", "Phishing"
cloudmersive.validate: UrlSsrfRequestBatch
Batch operation to perform SSRF threat checks on multiple URLs
Fields
- inputItems? UrlSsrfRequestFull[] - Input URLs to check for SSRF threats
cloudmersive.validate: UrlSsrfRequestFull
Request to determine if a URL is an SSRF threat check
Fields
- blockedDomains? string[] - Top level domains that you do not want to allow access to, e.g. mydomain.com - will block all subdomains as well
- uRL? string - URL to validate
cloudmersive.validate: UrlSsrfResponseBatch
Result of performing SSRF threat checks on multiple URLs
Fields
- outputItems? UrlSsrfResponseFull[] - Results of the operation, with indexes matched to input values
cloudmersive.validate: UrlSsrfResponseFull
Result of checking a URL for SSRF threats
Fields
- threatLevel? string - Threat level of the URL; possible values are High, Medium, Low and None
- cleanURL? boolean - True if the URL is clean, false if it is at risk of containing an SSRF threat or attack
cloudmersive.validate: UserAgentValidateRequest
User-Agent parse and validation request
Fields
- userAgentString? string - The user agent string you wish to parse and validate
cloudmersive.validate: UserAgentValidateResponse
The result of a User-Agent validation request
Fields
- operatingSystem? string - Operating System of the User-Agent (e.g. Windows)
- deviceModel? string - Model name or number of the User-Agent
- browserName? string - Name of the Browser
- isBot? boolean - True if the request is a known robot, false otherwise
- operatingSystemVersion? string - The version of the operating system of the User-Agent (e.g. "10" for Windows 10)
- deviceBrandName? string - Brand name of the User-Agent
- successful? boolean - True if the operation was successful, false otherwise
- browserEngineVersion? string - Version of the Browser Engine
- deviceType? string - Device type of the User-Agent; possible values are "DESKTOP", "SMARTPHONE", "TABLET"
- operatingSystemCPUPlatform? string - The CPU platform of the User-Agent (e.g. x64)
- botURL? string - Optional; if available, the URL to the robot
- browserEngineName? string - Name of the Browser Engine
- browserVersion? string - Version of the Browser
- botName? string - Optional; name of the robot if the request was from a known robot, otherwise null
cloudmersive.validate: ValidateAddressRequest
Request to Validate a Street Address
Fields
- streetAddress? string - Required; Street address to validate, such as '2950 Buskirk Ave.'
- stateOrProvince? string - Required; State or province of the address to validate, such as 'CA' or 'California'
- postalCode? string - Optional (recommended); Zip code or postal code of the address to validate, such as '94597'
- countryFullName? string - Optional (recommended); Name of the country, such as 'United States'. If left blank, and CountryCode is also left blank, will default to United States. Global countries are supported
- city? string - Required; City part of the addrerss to validate, such as 'Walnut Creek'
- countryCode? string - Optional; two-letter country code (Two-letter ISO 3166-1 country code) of the country. If left blank, and CountryFullName is also left blank, will default to United States. Global countries are supported
cloudmersive.validate: ValidateAddressResponse
Result of validating a street address
Fields
- validAddress? boolean - True if the address is valid, false otherwise
- latitude? decimal - If the address is valid, the degrees latitude of the validated address, null otherwise
- longitude? decimal - If the address is valid, the degrees longitude of the validated address, null otherwise
cloudmersive.validate: ValidateCityRequest
Request to Validate a City and State or Province in a country
Fields
- stateOrProvince? string - Required: State or province of the address to validate, such as 'California' or 'CA'
- countryFullName? string - Optional (recommended); Name of the country, such as 'United States'. If left blank, and CountryCode is also left blank, will default to United States. Global countries are supported
- city? string - Required: City of the address to validate, such as 'San Francisco' or 'London'
- countryCode? string - Optional; two-letter country code (Two-letter ISO 3166-1 country code) of the country. If left blank, and CountryFullName is also left blank, will default to United States. Global countries are supported
cloudmersive.validate: ValidateCityResponse
Result of validating a city
Fields
- stateOrProvince? string - If valid; State or province corresponding to the input state name, such as 'CA' or 'California'
- validCity? boolean - True if the city is valid, false otherwise
- latitude? decimal - If the postal code is valid, the degrees latitude of the centroid of the state, null otherwise
- city? string - If valid, City corresponding to the input postal code, such as 'Walnut Creek'
- longitude? decimal - If the postal code is valid, the degrees longitude of the centroid of the state, null otherwise
cloudmersive.validate: ValidateCountryRequest
Input parameter to a country validation request
Fields
- rawCountryInput? string - Raw country input - can be a two-letter code (FIPS 10-4 or ISO 3166-1), three-letter code (ISO 3166-1) or country name
cloudmersive.validate: ValidateCountryResponse
Result of performing a country validation operation
Fields
- subregion? string - Subregion in which the country is located; possible values are None, NorthernEurope, WesternEurope, SouthernEurope, EasternEurope, CentralAmerica, NorthernAmerica, SouthAmerica, EasternAfrica, MiddleAfrica, NorthernAfrica , SouthernAfrica , WesternAfrica , CentralAsia , EasternAsia , SouthernAsia , SouthEasternAsia , WesternAsia , Southern , Middle , AustraliaandNewZealand , Melanesia , Polynesia , Micronesia , Caribbean,
- fIPSTwoLetterCode? string - Two-letter FIPS 10-4 country code
- timezones? Timezone[] - Time zones (IANA/Olsen) in the country
- iSOCurrencyCode? string - ISO 4217 currency three-letter code associated with the country
- currencyEnglishName? string - Full name of the currency
- countryFullName? string - Full name of the country
- region? string - Region (continent) in which the country is located; possible values are None, Europe, Americas, Asia, Africa, Oceania
- threeLetterCode? string - Three-letter ISO 3166-1 country code
- iSOTwoLetterCode? string - Two-letter ISO 3166-1 country code
- successful? boolean - True if successful, false otherwise
- isEuropeanUnionMember? boolean - True if this country is currently a member of the European Union (EU), false otherwise
- currencySymbol? string - Symbol associated with the currency
cloudmersive.validate: ValidateIdentifierRequest
Identifier validation request, including the input identifier as well as various identifier rules
Fields
- allowWhitespace? boolean - True if whitespace is allowed in the identifier, false otherwise
- input? string - Text string identifier input
- allowNumbers? boolean - True if numbers are allowed in the identifier, false otherwise
- allowPeriods? boolean - True if periods are allowed in the identifier, false otherwise
- allowUnderscore? boolean - True if underscores are allowed in the identifier, false otherwise
- allowHyphens? boolean - True if hyphens are allowd in the identifier, false otherwise
- minLength? Signed32 - Optional; minimum length, if any, of the identifier
- maxLength? Signed32 - Optional; maximum length, if any, of the identifier
cloudmersive.validate: ValidateIdentifierResponse
Result of performing an identifier validation operation
Fields
- validIdentifier? boolean - True if the input identifier is valid, false otherwise
- 'error? string - Resulting error from the identifier validation; possible errors are: "InputIsEmpty", "ContainsWhitespace", "ContainsNumbers", "ContainsHyphen", "ContainsUnderscore", "ContainsPeriod", "TooShort", "TooLong", "ContainsSpecialCharacters"
cloudmersive.validate: ValidatePostalCodeRequest
Request to Validate a Postal Code
Fields
- postalCode? string - Required: Zip code or postal code of the address to validate, such as '94597'
- countryFullName? string - Optional (recommended); Name of the country, such as 'United States'. If left blank, and CountryCode is also left blank, will default to United States. Global countries are supported
- countryCode? string - Optional; two-letter country code (Two-letter ISO 3166-1 country code) of the country. If left blank, and CountryFullName is also left blank, will default to United States. Global countries are supported
cloudmersive.validate: ValidatePostalCodeResponse
Result of validating a postal code
Fields
- stateOrProvince? string - If valid; State or province corresponding to the input postal code, such as 'CA' or 'California'
- latitude? decimal - If the postal code is valid, the degrees latitude of the centroid of the postal code, null otherwise
- city? string - If valid, City corresponding to the input postal code, such as 'Walnut Creek'
- longitude? decimal - If the postal code is valid, the degrees longitude of the centroid of the postal code, null otherwise
- validPostalCode? boolean - True if the Postal Code is valid, false otherwise
cloudmersive.validate: ValidateStateRequest
Request to Validate a State or Province in a country
Fields
- stateOrProvince? string - Required: State or province of the address to validate, such as 'California' or 'CA'
- countryFullName? string - Optional (recommended); Name of the country, such as 'United States'. If left blank, and CountryCode is also left blank, will default to United States. Global countries are supported
- countryCode? string - Optional; two-letter country code (Two-letter ISO 3166-1 country code) of the country. If left blank, and CountryFullName is also left blank, will default to United States. Global countries are supported
cloudmersive.validate: ValidateStateResponse
Result of validating a state
Fields
- validState? boolean - True if the address is valid, false otherwise
- stateOrProvince? string - If valid; State or province corresponding to the input state name, such as 'CA' or 'California'
- latitude? decimal - If the postal code is valid, the degrees latitude of the centroid of the state, null otherwise
- longitude? decimal - If the postal code is valid, the degrees longitude of the centroid of the state, null otherwise
cloudmersive.validate: ValidateUrlRequestFull
Request to determine if a URL is valid
Fields
- uRL? string - URL to validate
cloudmersive.validate: ValidateUrlRequestSyntaxOnly
Request to determine if a URL is valid
Fields
- uRL? string - URL to validate
cloudmersive.validate: ValidateUrlResponseFull
Result of validating a URL with full validation
Fields
- validURL? boolean - True if the URL has valid syntax, a valid domain, a valid endpoint, and passes virus scan checks; false otherwise
- validSyntax? boolean - True if the URL has valid syntax, false otherwise
- validEndpoint? boolean - True if the endpoint is up and responsive and passes a virus scan check, false otherwise
- validDomain? boolean - True if the domain name is valid and exists, false otherwise
- wellFormedURL? string - Well-formed version of the URL
cloudmersive.validate: ValidateUrlResponseSyntaxOnly
Result of validating a URL with syntax only
Fields
- validURL? boolean - True if the URL is valid, false otherwise
- topLevelDomainName? string - The top-level domain name of the URL, e.g. mydomain.com
- wellFormedURL? string - Well-formed version of the URL
cloudmersive.validate: VatLookupRequest
Input to a VAT lookup request
Fields
- vatCode? string - VAT code to lookup; example "CZ25123891"
cloudmersive.validate: VatLookupResponse
Fields
- businessStreetNumber? string - For the business address, the street number or house number of the address. For example, in the address "1600 Pennsylvania Avenue NW" the street number would be "1600". This value will typically be populated for most addresses
- businessCity? string - For the business address, the city of the address
- businessName? string - Name of the business
- businessBuilding? string - For the business address, the name of the building, house or structure if applicable, such as "Cloudmersive Building 2". This will often by null
- businessStreet? string - For the business address, the name of the street or road of the address. For example, in the address "1600 Pennsylvania Avenue NW" the street number would be "Pennsylvania Avenue NW"
- businessPostalCode? string - For the business address, the postal code or zip code of the address
- businessStateOrProvince? string - For the business address, the state or province of the address
- countryCode? string - Two-letter country code
- businessCountry? string - For the business address, country of the address, if present in the address. If not included in the address it will be null
- vatNumber? string - VAT number
- businessAddress? string - Business address as a single string
- isValid? boolean - True if the VAT code is valid, false otherwise
cloudmersive.validate: WhoisResponse
Result of a WHOIS operation
Fields
- whoisServer? string - Server used to lookup WHOIS information (may change based on lookup)
- createdDt? string - Creation date for the record
- validDomain? boolean - True if the domain is valid, false if it is not
- registrantTelephone? string - Telephone number of the address of the domain registrant
- registrantCity? string - City of the domain registrant, if available
- registrantStreet? string - Street name of the address of the domain registrant, if available
- registrantStreetNumber? string - Street number of the address of the domain registrant, if available
- registrantCountry? string - Country of the address of the domain registrant, if available
- registrantPostalCode? string - Postal code of the address of the domain registrant, if available
- registrantName? string - Name of the domain registrant
- registrantStateOrProvince? string - State or Province of the address of the domain registrant, if available
- registrantRawAddress? string - Raw address string of the domain registrant, if available
- registrantEmail? string - Email address of the domain registrant
- rawTextRecord? string - WHOIS raw text record
- registrantOrganization? string - Organization name of the domain registrant
cloudmersive.validate: XssProtectionBatchRequest
Input to a batch XSS protection operation
Fields
- requestItems? XssProtectionRequestItem[] - Multiple items to protect for XSS
cloudmersive.validate: XssProtectionBatchResponse
Result of performing a batch XSS protection operation
Fields
- resultItems? XssProtectionResult[] - Results from performing a batch XSS protection operation
cloudmersive.validate: XssProtectionRequestItem
Individual item to protect for XSS
Fields
- inputText? string - Individual input text item to protect from XSS
cloudmersive.validate: XssProtectionResult
Result of performing an XSS protection operation
Fields
- normalizedResult? string - Normalized string result, with XSS removed
- containedXss? boolean - True if the input contained XSS scripting, false otherwise
- successful? boolean - True if the operation was successful, false otherwise
- originalInput? string - Original input string
cloudmersive.validate: XxeDetectionBatchRequest
Input to a batch XXE detection operation
Fields
- requestItems? XxeDetectionRequestItem[] - Multiple items to protect for XXE
cloudmersive.validate: XxeDetectionBatchResponse
Result of performing a batch XXE detection operation
Fields
- resultItems? XxeDetectionResult[] - Results from performing a batch XSS protection operation
cloudmersive.validate: XxeDetectionRequestItem
Individual item to detect for XXE
Fields
- allowInternetUrls? boolean - Optional: Set to true to allow Internet-based dependency URLs for DTDs and other XML External Entitites, set to false to block. Default is false
- knownSafeUrls? string[] - Optional: Comma separated list of fully-qualified URLs that will automatically be considered safe
- inputText? string - Individual input text item to protect from XXE
- knownUnsafeUrls? string[] - Optional: Comma separated list of fully-qualified URLs that will automatically be considered unsafe
cloudmersive.validate: XxeDetectionResult
Result of performing an XXE threat detection operation
Fields
- successful? boolean - True if the operation was successful, false otherwise
- containedXxe? boolean - True if the input contained XXE threats, false otherwise
Import
import ballerinax/cloudmersive.validate;Metadata
Released date: about 15 hours ago
Version: 2.0.0
License: Apache-2.0
Security
Direct vulnerabilities: No known direct vulnerabilities
Indirect vulnerabilities:
Checked on 2026-11-20 via OSV.dev
Compatibility
Platform: any
Ballerina version: 2201.12.0
GraalVM compatible: Yes
Pull count
Total: 56
Current verison: 1
Weekly downloads
Keywords
Vendor/Cloudmersive
Area/Developer Tools
Type/Connector
Contributors