Basic Utilty Services

Basic Utility Services are ready-made webhook services that could solve your day-to-day issues with Marketo.

1. Scope

This document describes the API details for different Basic Utility Services of Right Data Normalizer (RDN) services provided by RightWave.

2. Process

Basic Utility Services are ready-made webhook services that could solve your day-to-day issues with Marketo. For example, you could add two scores, you could get a domain from email, etc. RightWave has provided 40 basic utility services and RightWave can develop more services in the future as per the requirement. These services will come under a freemium subscription of RDN. All of these services support the HTTP GET Method only.

3. All Available Basic Services:

The following Basic Utility Services are included in RDN:

S no

Service Name 

Description

1

A Contains B String With Case

To find a String B in String A with a case.

2

Add Period After Ms

To add periods after Ms in a string.

3

Add Periods to Initials

To add periods to initials in a string.

4

Add Prefixes to Abbreviation

To add abbreviations as prefixes.

5

Add score

To add two scores.

6

Calculate Age

To calculate age based on D.O.B.

7

Company Abbreviation

To shorten the ‘Company’ or ‘and Company’ word as ‘& Co.’ in a string.

8

Compare Date

To compare two date fields 

9

Compass Directions Abbreviate

To shorten compass directions.

10

Convert Middle Name To Initials

To convert middle names to initials in a string.

11

Convert To Lowercase

To convert a string value in lowercase.

12

Convert To Propercase

To convert a string of every word’s first letter into uppercase.

13

Convert To Uppercase

To convert a string value in upper case.

14

Count Characters

To get the number of characters in a string.

15

Count Words

To count the words in the string.

16

Decrement Date Field

To decrease the number of days in an input date.

17

Domain From Email

To get the domain from the email.

18

Email syntax Validation

To validate an email syntax

19

Fetch Domain

To get a domain from a URL.

20

Format Currency

To format a numerical value into currency.

21

Get Clean Country Name

To get clean country from raw country.

22

getStateCodeFromCountry

To get state code from country and state.

23

Increment DateField

To increment the number of days in an input date.

24

isISPDomain

To get ISP Domain.

25

Junk Score

To provide junk score to records based on the fields: firstName, lastName, ema…

26

Ordinalize Number

To add ordinalize a number.

27

Pluralize String

To get the plural value for a string.

28

Remove Hyphens

To remove hyphens from a string.

29

Remove Protocol

To remove the protocol from the URL.

30

Remove Trailing Slash

To remove a slash at the end of a URL.

31

Remove WWW

To remove www. from a URL.

32

Replace A With B In C String

To replace a string A with B in a string C without a case.

33

Replace A With B In C String With Case

To replace a string A with B in a string C with case.

34

Reverse String

To reverse a string.

35

Split String

To split a string with a delimiter.

36

Street Type Abbreviation

To shorten the Street word as St. in a string.

37

String A Contains String B

To find a String B in String A.

38

Substring

To get part of a string from a string.

39

Suffixes Corp

To shorten the Corporation word as Corp. in a string.

40

Suffixes Inc

To shorten the Incorporated word as Inc. in a string.

41

Suffixes Int’l

To shorten the International word as Int’l in a string.

42

Suffixes Ltd Abbreviation

To shorten the Limited word as Ltd. in a string.

43

Whitespace Compact

To remove whitespaces from a string.

44

Wildcard Pattern Matching

To match a string from patterns.

4. Basic Utility APIs

4.1 Add score 

API Name

add score

Description

You can use this service to add two scores. For example, You have an Integer named score1 with the value of 10 and another Integer named score2 with the value of 25 The API will return an integer with value of 35.

URL

https://api.rightwave.net/rdn/api/ss/addScore?int_score1={Marketo token for int_score1}&int_score2={Marketo token for int_score2}

Headers

 

Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

use for authentication

Content-Type

application/json

accept application/json

 

Query Parameters


Parameter Name

Data Type

Description

int_score1

Integer

first input for addscore

int_score2

Integer

second input for addscore

Output

{

“success”: true,

“input”: {

“int_score1”: “3”,

“int_score2”: “2”

},

“result”: {

“sum”: 5

},

“requestId”: “21666676345885609”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/addScore?int_score1=3&int_score2=2

4.2 Count Words

API Name

countWords

Description

You can use this service to count the words in a string. For example, You have a String named str with the value “count words” The API will return Integer value 2.

URL

https://api.rightwave.net/rdn/api/ss/countWords?input={Marketo token for input}

Headers

 

Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameter

 

Parameter Name

Data Type

Description

string_1

String

Input for countWords

Output Parameters

{

“success”: true,

“input”: {

“input”: “count words”

},

“result”: {

“output”: 2

},

“requestId”: “2166675751947232”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/countWords?input=count words”

4.3 Count Characters 

API Name

countChar

Description

You can use this service to get the number of characters in a string. For example, You have a String named str with the value “count characters” The API will return an Integer value of 16.

URL

https://api.rightwave.net/rdn/api/ss/countChar?input={Marketo token for input}

Headers

 

Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

use for authentication

Content-Type

application/json

Header for Content-Type

Query parameter

 

Parameter Name

Data Type

Description

string_1

String

Input for countChar

Output

{

“success”: true,

“input”: {

“input”: “count characters”

},

“result”: {

“output”: 16

},

“requestId”: “21666758167295391”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/countChar?input=count characters”

4.4 Replace A With B in C With Case

API Name

replaceAWithBInCWithCase

Description

You can use this service to replace a string A with B in a string C withcase. For example, You have a String named str1 with value “center” and another string named str2 with value “hub” and another string named str3 with value “Information center”. The API will return the string value “Information hub”.

URL

https://api.rightwave.net/rdn/api/ss/replaceAWithBInCWithCase?inputA={Marketo token for inputA}&inputB={Marketo token for inputB}&inputC={Marketo token for inputC}


Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

inputA

String

First input for replaceAWithBInCWithCase

inputB

String

Second input for replaceAWithBInCWithCase

inputC

String

Third input for replaceAWithBInCWithCase

Output

{

“success”: true,

“input”: {

“inputA”: “center”,

“inputB”: “hub”,

“inputC”: “Information center”

},

“result”: {

“output”: “Information hub”

},

“requestId”: “2166676930320778”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/replaceAWithBInCWithCase?inputA=center&inputB=hub&inputC=Information center”

4.5 Replace A with B in C

API Name

replaceAWithBInC

Description

You can use this service to replace a string A with B in a string C without case. For example, You have a String named str1 with value “center” and another string named str2 with value “hub” and another string named str3 with value “Information center”. The API will return the string value “Information hub”.

URL

https://api.rightwave.net/rdn/api/ss/replaceAWithBInC?inputA={Marketo token for inputA}&inputB={Marketo token for inputB}&inputC={Marketo token for inputC}

Headers

 

Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query parameter

 

Parameter Name

Data Type

Description

inputA

String

First input for replaceAWithBInC

inputB

String

Second input for replaceAWithBInC

inputC

String

Third input for replaceAWithBInC

OutPut

{

“success”: true,

“input”: {

“inputA”: “center”,

“inputB”: “hub”,

“inputC”: “Information center”

},

“result”: {

“output”: “Information hub”

},

“requestId”: “21666770629521709”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/replaceAWithBInC?inputA=center&inputB=hub&inputC=Information center”

4.6 A Contains B with Case

API Name

aContainsBWithCase

Description

You can use this service to search a string in another string with case. For example, You have a String named str1 with value “newspaper” and another string named str2 with value “paper”. The API will return boolean value true.

URL

https://api.rightwave.net/rdn/api/ss/aContainsBWithCase?inputA={Marketo token for inputA}&inputB={Marketo token for inputB}}

Header


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name
Data Type
Description
inputA
String
First input for aContainsBWithCase
inputB
String
Second input for aContainsBWithCase

Output

{

“success”: true,

“input”: {

“inputA”: “news paper”,

“inputB”: “paper”

},

“result”: {

“output”: true

},

“requestId”: “21666857955047602”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/aContainsBWithCase?inputA=news paper&inputB=paper”

4.7 A Contains B

API Name

aContainsB

Description

You can use this service to search a string in another string with case. For example, You have a String named str1 with value “newspaper” and another string named str2 with value “paper”. The API will return boolean value true. 

URL

https://api.rightwave.net/rdn/api/ss/aContainsB?inputA={Marketo token for inputA}&inputB={Marketo token for inputB}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name
Data Type
Description
inputA
String
First input for aContainsB
inputB
String
Second input for aContainsB

Output

{

“success”: true,

“input”: {

“inputA”: “newspaper”,

“inputB”: “paper”

},

“result”: {

“output”: true

},

“requestId”: “2166685878478731”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/aContainsB?inputA=newspaper&inputB=paper”

4.8 Pluralize

API Name

pluralize

Description

You can use this service to get the plural value for a string. For example, You have a String named str with value “book” .The API will return string value “books”.

URL

https://api.rightwave.net/rdn/api/ss/pluralize?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input

String

Input for pluralize

Output

{

“success”: true,

“input”: {

“input”: “book”

},

“result”: {

“output”: “books”

},

“requestId”: “21666859230054769”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/pluralize?input=book”

4.9 String Reverse

API Name

stringReverse

Description

You can use this service to reverse a string. For example You have a String named str with value “world is good”. The API will return the string value “doog si dlrow”.

URL

https://api.rightwave.net/rdn/api/ss/stringReverse?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input

String

Input for stringReverse

Output

{

“success”: true,

“input”: {

“input”: “world is good”

},

“result”: {

“output”: “doog si dlrow”

},

“requestId”: “21666860934664902”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/stringReverse?input=world is good”

4.10 Sub String

API Name

subString

Description

You can use this service to get part of a string from a string. For example, You have a String named str with value “collection” and another Integer named startingIndex with value 1 and another Integer named endingIndex with value 4. The API will return String value “oll”.

URL

https://api.rightwave.net/rdn/api/ss/subString?input={Marketo token for input}&int_startIndex={Marketo token for int_startIndex}&int_endIndex={Marketo token for int_endIndex}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input
 

String

First input for subString

int_startIndex
 

Integer

Start index for subString

int_endIndex

Integer

Last index for subString

Output

{

“success”: true,

“input”: {

“input”: “basic service”,

“int_startIndex”: “2”,

“int_endIndex”: “5”

},

“result”: {

“output”: “sic”

},

“requestId”: “216668623429863”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/subString?input=basic service&int_startIndex=2&int_endIndex=5”

4.11 Convert to Lower Case

API Name

convertToLowerCase

Description

You can use this service to convert a string value into lower case. For example, You have a String named str with value “LOWER CASE” The API will return String value “lower case”.

URL

https://api.rightwave.net/rdn/api/ss/convertToLowerCase?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input
 

String

Input for convertToLowerCase

Output Parameters

{

“success”: true,

“input”: {

“input”: “LOWER CASE”

},

“result”: {

“output”: “lower case”

},

“requestId”: “21666869387206730”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/convertToLowerCase?input=LOWER CASE”

4.12 Convert to Upper Case

API Name

convertToUpperCase

Description

You can use this service to convert a string value into upper case. For example, You have a String named str with value “upper case” The API will return String value “UPPER CASE”.

URL

https://api.rightwave.net/rdn/api/ss/convertToUpperCase?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

accept application/json

Query Parameters


Parameter Name

Data Type

Description

input

String

Input for convertToUpperCase

Output

{

“success”: true,

“input”: {

“input”: “upper case”

},

“result”: {

“output”: “UPPER CASE”

},

“requestId”: “21666870891105363”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/convertToUpperCase?input=uppercase”

4.13 Convert to Proper Case

API Name

convertToProperCase

Description

You can use this service to convert a string of every word’s first letter into uppercase. For example, You have a String named str with value “uber” The API will return String value “Uber”.

URL

https://api.rightwave.net/rdn/api/ss/convertToProperCase?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input

String

Input for convertToProperCase

Output 

{

“success”: true,

“input”: {

“input”: “uber”

},

“result”: {

“output”: “Uber”

},

“requestId”: “21666871386544723”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/convertToProperCase?input=uber”

4.14 Ordinalize

API Name

ordinalize

Description

You can use this service to ordinalize a number . For example, You have an Integer named number with value 3. The API will return the string value “3rd”.

URL

https://api.rightwave.net/rdn/api/ss/ordinalize?int_Value={Marketo token for int_Value}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

int_Value
 

Integer

Input for ordinalize

Output

{

“success”: true,

“input”: {

“int_Value”: “3”

},

“result”: {

“output”: “3rd”

},

“requestId”: “21666878401015172”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/ordinalize?int_Value=3”

4.15 Validate Email

API Name

validateEmail

Description

You can use this service to validate an email. For example, You have a String named str with value “Johnsmith@gmail.com” . The API will return String value “valid”.

URL

https://api.rightwave.net/rdn/api/ss/validateEmail?email={Marketo token for email}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

email
 
 

String

Input for validateEmail

Output

{

“success”: true,

“input”: {

“email”: “Johnsmith@gmail.com”

},

“result”: {

“output”: “valid”

},

“requestId”: “21666878682541658”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/validateEmail?email=Johnsmith@gmail.com”

4.16 Domain from Email

API Name

domainFromEmail

Description

You can use this service to get the domain from the email. For example, You have a String named str with value “jsmith@gmail.com” The API will return string value “gmail.com”.

URL

https://api.rightwave.net/rdn/api/ss/domainFromEmail?emailAddress={Marketo token for emailAddress}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

email address
 

String

Input for domainFromEmail

Output

{

“success”: true,

“input”: {

“emailAddress”: “jsmith@gmail.com”

},

“result”: {

“output”: “gmail.com”

},

“requestId”: “2166687928181941”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/domainFromEmail?emailAddress=jsmith@gmail.com”

4.17 Increment Date Field

API Name

incrementDateField

Description

You can use this service to increment the number of days in an input date. For example 

  1. You have a String named str1 with value “2022-02-21” and another string named format with value “yyyy-MM-dd” and another Integer named days with value 1, The API will return String value “2022-02-22”. 
  2. You have a String named str1 with value “2022-02-21 08:44:22” and an another string named format with value “yyyy-MM-dd hh:mm:ss” and an another Integer named days with value 1, The API will return String value “2022-02-22 08:44:22”.

URL

https://api.rightwave.net/rdn/api/ss/incrementDateField?str_input_date={Marketo token for str_input_date}&input_format={Marketo token for input_format}&int_numberOfDays={Marketo token for int_numberOfDays}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

str_input_date
 

String

First date for incrementDateField

input_format

String

Second input for incrementDateField

int_numberOfDays

Integer

Third input for incrementDateField

Output

{

“success”: true,

“input”: {

“str_input_date”: “2022-02-21 08:44:22”,

“input_format”: “yyyy-MM-dd hh:mm:ss”,

“int_numberOfDays”: “1”

},

“result”: {

“output”: “2022-02-22 08:44:22”

},

“requestId”: “21666880273355791”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/incrementDateField?str_input_date=2022-02-21 08:44:22&input_format=yyyy-MM-dd hh:mm:ss&int_numberOfDays=1”

4.18 Decrement Date Field

API Name

decrementDateField

Description

You can use this service to decrease the number of days in an input date. For example

  1. You have a String named str1 with value “1992-05-10” and an another string named format with value “yyyy-MM-dd” and an another Integer named days with value 1 , The API will return String value “1992-05-09”.
  2. You have a String named str1 with value “1992-05-10 06:44:22” and an another string named format with value “yyyy-MM-dd hh:mm:ss” and an another Integer named days with value 1 , The API will return String value “1992-05-09 06:44:22”.

URL

https://api.rightwave.net/rdn/api/ss/decrementDateField?str_input_date={Marketo token for str_input_date}&input_format={Marketo token for input_format}&int_numberOfDays={Marketo token for int_numberOfDays}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

str_input_date
 

String

First input for decrementDateField

input_format

String

Second input for decrementDateField

int_numberOfDays
 

Integer

Third input for decrementDateField

Output 

{

“success”: true,

“input”: {

“str_input_date”: “1992-05-10 06:44:22”,

“input_format”: “yyyy-MM-dd hh:mm:ss”,

“int_numberOfDays”: “1”

},

“result”: {

“output”: “1992-05-09 06:44:22”

},

“requestId”: “21666961639143640”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/decrementDateField ?str_input_date=1992-05-10 06:44:22&input_format=yyyy-MM-dd hh:mm:ss&int_numberOfDays=1”

4.19 Compare Date

API Name

compareDate

Description

You can use this service to compare two date fields. For example,

  1. You have a String named date1 with value “2022-01-21” and another string named date2 with value “2022-02-21” and another string named format with value “yyyy-MM-dd” The API will return boolean value true.
  2. You have a String named date1 with value “2022-02-21” and another string named date2 with value “2022-02-21” and another string named format with value “yyyy-MM-dd” The API will return a boolean value false.
  3. You have a String named date1 with value “2022-01-21 06:44:22” and an another string named date2 with value “2022-02-21 08:44:22” and an another string named format with value “yyyy-MM-dd hh:mm:ss” The API will return boolean value true.

URL

https://api.rightwave.net/rdn/api/ss/compareDate?str_input_date_1={Marketo token for str_input_date_1}&str_input_date_2={Marketo token for str_input_date_2}&input_format={Marketo token for input_format}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

str_input_date_1
 

String

First input for compareDate

str_input_date_2

String

Second input for compareDate

input_format
 

String

Third input for compareDate

Output

{

“success”: true,

“input”: {

“str_input_date_1”: “2022-01-21 06:44:22”,

“str_input_date_2”: “2022-02-21 08:44:22”,

“input_format”: “yyyy-MM-dd hh:mm:ss”

},

“result”: {

“output”: true

},

“requestId”: “21666962454956172”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/compareDate?str_input_date_1=2022-01-21 06:44:22&str_input_date_2=2022-02-21 08:44:22&input_format=yyyy-MM-dd hh:mm:ss”

4.20 Calculate Age

API Name

calculateAge

Description

You can use this service to calculate age on the basis of dob. For example

  1. You have a variable named dateOfBirth with value “1992-05-01” . You also have to specify the Date format of the DateofBirth variable like “yyyy-MM-dd” The API will return integer value 30.
  2. You have a variable named dateOfBirth with value “1992-05-01” . You also have to specify the Date format of the DateofBirth variable like “yyyy-MM-dd” The API will return integer value 30.

URL

https://api.rightwave.net/rdn/api/ss/calculateAge?userinput={Marketo token for userinput}&input_format={Marketo token for input_format}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

str_input_date
 
 

String

First input for calculateAge

input_format
 

String

Second input for calculateAge

Output

{

“success”: false,

“input”: {

“str_input_date”: “1992-05-01”,

“input_format”: “yyyy-MM-dd”

},

“error”: {

“code”: 1006,

“message”: “The request could not be processed by the server due to malformed syntax or missing input parameter(s).”

},

“requestId”: “21666963338566488”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/calculateAge?str_input_date=1992-05-01&input_format=yyyy-MM-dd”

4.21 Remove Trailing Slash

API Name

removeTrailingSlash

Description

You can use this service to remove a slash at the end of a URL. For example, You have a String named str with value “https://salesforce.com/” . The API will return the string value “https://salesforce.com”.

URL

https://api.rightwave.net/rdn/api/ss/removeTrailingSlash?input={Marketo token for input}

Headers

 

Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters

 

Parameter Name

Data Type

Description

input
 

String

Input for removeTrailingSlash

Output 

{

“success”: true,

“input”: {

“input”: “https://salesforce.com/”

},

“result”: {

“output”: “https://salesforce.com”

},

“requestId”: “2166696378049770”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/removeTrailingSlash?input=https://salesforce.com/”

4.22 Remove www

API Name

removeWWW

Description

You can use this service to remove www. from a URL. For example, You have a String named str with value “https://www.google.com“. The API will return the string value “google.com”.

URL

https://api.rightwave.net/rdn/api/ss/removeWWW?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input
 

String

Input for removeWWW

Output

{

“success”: true,

“input”: {

“input”: “https://www.rightwave.com”

},

“result”: {

“output”: “rightwave.com”

},

“requestId”: “21666964215757967”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/removeWWW?input=https://www.rightwave.com”

4.23 Wild Card Pattern Matching

API Name

wildcardPatternMatching

Description

You can use this service to match a string from a pattern. The input fields below tells about the name of the request parameters whose values will be passed from Marketo. The output parameter tells about the key in the output JSON which will be mapped to the respective field in Marketo.

URL

https://api.rightwave.net/rdn/api/ss/wildcardPatternMatching?expressions={Marketo token for expressions}&input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

expressions
 
 

String

First input for wildcardPatternMatching

input

String

Second input for wildcardPatternMatching

Output

{

“success”: true,

“input”: {

“expressions”: “c*t*”,

“input”: “cater”

},

“result”: {

“output”: true

},

“requestId”: “216669646402641”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/wildcardPatternMatching?expressions=c*t*&input=cater”

 

4.24 Format Currency

API Name

format currency

Description

You can use this service to format a numerical value into currency. For example, You have an Integer named number with value 2000 . The API will return an Integer value of $2,000.00.

URL

https://api.rightwave.net/rdn/api/ss/formatCurrency?inputStr={Marketo token for inputStr}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

inputStr
 
 

Number

Input for formatCurrency

Output 

{

“success”: true,

“input”: {

“inputStr”: “2000”

},

“result”: “$2,000.00”,

“requestId”: “21666965086148813”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/formatCurrency?inputStr=2000”

4.25 Remove Hyphens

API Name

removeHyphens

Description

You can use this service to remove hyphens from a string. For example, You have a String named str with value “sign-in”. The API will return the string value “sign in”.

URL

https://api.rightwave.net/rdn/api/ss/removeHyphens?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input
 

String

Input for removeHyphens

Output 

{

“success”: true,

“input”: {

“input”: “sign-in”

},

“result”: {

“output”: “sign in”

},

“requestId”: “21667197994416144”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/removeHyphens?input=sign-in”

4.26 Remove Protocol

API Name

removeProtocol

Description

You can use this service to remove the protocol from url . For example, You have a String named str with value “https://www.rightwave.com”. The API will return the string value “www.rightwave.com”.

URL

https://api.rightwave.net/rdn/api/ss/removeProtocol?input={Marketo token for input}

HTTP Method


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input
 

String

Input for removeProtocol

Output

{

“success”: true,

“input”: {

“input”: “https://www.rightwave.com”

},

“result”: {

“output”: “www.rightwave.com”

},

“requestId”: “21667198680119735”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/removeProtocol?input=https://www.rightwave.com”

4.27 Split String

API Name

splitString

Description

You can use this service to split a string with a delimiter. For example, You have a String named str with value “car*bike” and an another string named delimiter with value “*” .The API will return string values as output1: “car”, output2″: “bike” .

URL

https://api.rightwave.net/rdn/api/ss/splitString?input={Marketo token for input}&delimeter={Marketo token for delimeter}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input

String

First input for splitString

delimiter

String

Second input for splitString

Output

{

“success”: true,

“input”: {

“input”: “car*bike”,

“delimeter”: “*”

},

“result”: {

“output”: {

“output1”: “car”,

“output2”: “bike”

}

},

“requestId”: “21667204885203631”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/splitString?input=car*bike&delimeter=*”

4.28 WhiteSpace Compact

API Name

whitespaceCompact

Description

You can use this service to remove whitespaces from a string. For example, You have a String named str with value “Basic Service”. The API will return the String value “BasicService”.

URL

https://api.rightwave.net/rdn/api/ss/whitespaceCompact?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input

String

Input for whitespaceCompact

Output

{

“success”: true,

“input”: {

“input”: “Basic Service”

},

“result”: {

“output”: “BasicService”

},

“requestId”: “21667207565668385”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/whitespaceCompact?input=Basic Service”

4.29 Suffix Inc

API Name

suffixesInc

Description

You can use this service to shorten Incorporated word as Inc. in a string. For example, You have a String named str with value “Microsoft Incorporated” . The API will return String value “Microsoft Inc.”.

URL

https://api.rightwave.net/rdn/api/ss/suffixesInc?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input

String

Input for suffixesInc

OutPut

{

“success”: true,

“input”: {

“input”: “Microsoft Incorporated”

},

“result”: {

“output”: “Microsoft Inc.”

},

“requestId”: “21667207889444510”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/suffixesInc?input=Microsoft Incorporated”

4.30 Suffix Corp

API Name

suffixesCorp

Description

You can use this service to shorten Corporation word as Corp. in a string. For example, You have a String named str with value “Food Corporation” . The API will return String value “Food Corp.”.

URL

https://api.rightwave.net/rdn/api/ss/suffixesCorp?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input

String

Input for suffixesCorp

Output 

{

“success”: true,

“input”: {

“input”: “Food Corporation”

},

“result”: {

“output”: “Food Corp.”

},

“requestId”: “21667208851113886”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/suffixesCorp?input=Food Corporation”

4.31 Suffix Intl

API Name

suffixesIntl

Description

You can use this service to shorten International word as Int’l in a string. For example, You have a String named str with value “spgr international” . The API will return the String value “spgr Int’l.”.

URL

https://api.rightwave.net/rdn/api/ss/suffixesIntl?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type


Query Parameters


Parameter Name

Data Type

Description

input

String

Input for suffixesIntl

Output

{

“success”: true,

“input”: {

“input”: “SPGR INTERNATIONAL”

},

“result”: {

“output”: “SPGR Int’l.”

},

“requestId”: “21667209791526946”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/suffixesIntl?input=SPGR INTERNATIONAL”

4.32 Company Abbreviation

API Name

companyAbbreviation

Description

You can use this service to shorten ‘Company’ or ‘and Company’ word as & Co. in a string. For example

  1. You have a String named str with value “Imperial Sugar Company” The API will return String value “Imperial Sugar & Co.”.
  2. You have a String named str with value “Imperial Sugar and Company” The API will return String value “Imperial Sugar & Co.”.

URL

https://api.rightwave.net/rdn/api/ss/companyAbbreviation?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input

String

Input for companyAbbreviation

Output 

{

“success”: true,

“input”: {

“input”: “Imperial Sugar Company”

},

“result”: {

“output”: “Imperial Sugar & Co.”

},

“requestId”: “21667210519613422”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/companyAbbreviation?input=Imperial Sugar Company”

4.33 Suffixes Ltd Abbreviation

API Name

suffixesLtdAbbreviation

Description

You can use this service to shorten Limited word as Ltd. in a string. For example, You have a String named str with value “RightWave Infosolution Private Limited” . The API will return String value “RightWave Infosolution Private Ltd.”.

URL

https://api.rightwave.net/rdn/api/ss/suffixesLtdAbbreviation?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input

String

Input for suffixesLtdAbbreviation

Output 

{

“success”: true,

“input”: {

“input”: “RightWave Infosolution Private Limited”

},

“result”: {

“output”: “RightWave Infosolution Private Ltd.”

},

“requestId”: “21667212700607973”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/suffixesLtdAbbreviation?input=RightWave Infosolution Private Limited”

4.34 Periods Add After Ms

API Name

periodsAddAfterMs

Description

You can use this service to add periods after Ms in string. For example, You have a String named str with value “Ms Emma” The API will return String with value “Ms. Emma”.

URL

https://api.rightwave.net/rdn/api/ss/periodsAddAfterMs?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input

String

Input for periodsAddAfterMs

Output 

{

“success”: true,

“input”: {

“input”: “Ms Mary”

},

“result”: {

“output”: “Ms. Mary”

},

“requestId”: “21667216993022888”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/periodsAddAfterMs?input=Ms Mary”

4.35 Compass Directions Abbreviate

API Name

compassDirectionsAbbreviate

Description

You can use this service to shorten compass directions. For example, You have a String named str with value “SOUTHWEST” The API will return String value “S.W.”.

URL

https://api.rightwave.net/rdn/api/ss/compassDirectionsAbbreviate?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input

String

Input for compassDirectionsAbbreviate

Output

{

“success”: true,

“input”: {

“input”: “SOUTHWEST”

},

“result”: {

“output”: “S.W.”

},

“requestId”: “21667217501945384”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/compassDirectionsAbbreviate?input=SOUTHWEST”

4.36 Street Type Abbreviation

API Name

streetTypeAbbreviation

Description

You can use this service to shorten Street word as St. in a string. For example, You have a String named str with value “Street” . The API will return string values “St.”

URL

https://api.rightwave.net/rdn/api/ss/streetTypeAbbreviation?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input

String

Input for streetTypeAbbreviation

Output

{

“success”: true,

“input”: {

“input”: “Street”

},

“result”: {

“output”: “St.”

},

“requestId”: “21667217794458731”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/streetTypeAbbreviation?input=Street”

4.37 Fetch Domain

API Name

fetchDomain

Description

You can use this service to get a domain from a URL. For example, You have a String named str with value “https://www.google.com” The API will return string value “google.com”.

URL

https://api.rightwave.net/rdn/api/ss/fetchDomain?inputURL={Marketo token for inputURL}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input

String

Input for fetchDomain

Output 

{

“success”: true,

“input”: {

“inputURL”: “https://www.rightwave.com”

},

“result”: {

“output”: “rightwave.com”

},

“requestId”: “21667218719242612”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/fetchDomain?inputURL=https://www.rightwave.com”

4.38 Initials Add Period

API Name

initialsAddPeriods

Description

You can use this service to add periods to initials in a string. For example, You have a String named str with value “John Smith” The API will return String with value “J. Smith” .

URL

https://api.rightwave.net/rdn/api/ss/initialsAddPeriods?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input

String

Input for initialsAddPeriods

OutPut

{

“success”: true,

“input”: {

“input”: “John Smith”

},

“result”: {

“output”: “J. Smith”

},

“requestId”: “21667219317617495”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/initialsAddPeriods?input=John Smith”

4.39 Middle Name Convert to Initial

API Name

middleNameConvertToInitial

Description

You can use this service to convert middle names to initials in a string. For example

  1. You have a String named name with value “Mr John Smith” The API will return String value “Mr J. Smith”.
  2. You have a String named name with value “Jonn Mile Smith” The API will return String value “Jonn M. Smith”.

URL

https://api.rightwave.net/rdn/api/ss/middleNameConvertToInitial?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input

String

Input for middleNameConvertToInitial

Output

{

“success”: true,

“input”: {

“input”: “Mr Jonn Smith”

},

“result”: {

“output”: “Mr J. Smith”

},

“requestId”: “21667220439918991”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/middleNameConvertToInitial?input=Mr Jonn Smith”

4.40 Prefix Abbreviation 

API Name

prefixesAbbreviation

Description

You can use this service to add abbreviations as prefixes. For example, You have a String named str with value “Saint John” The API will return String with value “St. John”.

URL

https://api.rightwave.net/rdn/api/ss/prefixesAbbreviation?input={Marketo token for input}

Headers


Key Name

Value

Description

auth-key

5wt-be28f07942848582b5915443

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

input

String

Input for prefixesAbbreviation

Output

{

“success”: true,

“input”: {

“input”: “Saint John”

},

“result”: {

“output”: “St. John”

},

“requestId”: “21667220802574198”

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 5wt-be28f07942848582b59154453’ \

“https://api.rightwave.net/rdn/api/ss/prefixesAbbreviation?input=Saint John”

4.41 Get Clean Country Name

API Name

getCleanCountryName

Description

You can use this service to get a clean country from a raw country. For example, You have a string named rawCountry with the value “AF” The API will return the string with the value “Afghanistan”.

URL

https://api.rightwave.com/rdn/api/ss/getCleanCountryName?rawCountry={Marketo token for rawCountry}

Headers

 

Key Name

Value

Description

auth-key

62m-8db697ee26b6eb4e17876775

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters

 

Parameter Name

Data Type

Description

rawCountry

String

first input for getCleanCountryName

Output

{

         success

(boolean) : Whether the request succeed or not,

         input

: {

                 rawCountry(String) : Contains the value of

rawCountry as String

         },

         result

: {

                 output(String) : Contains clean country from

rawCountry

         },

         error

: {

                 code(Int) : Error code on case of error,

                 message(String) : Message related to error code

         },

         requestId(String)

: RequestId generated in RDN to track the search

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 62m-8db697ee26b6eb4e17876775’ \

“https://api.rightwave.com/rdn/api/ss/getCleanCountryName?rawCountry=AF”

4.42 Get State Code From Country

API Name

getStateCodeFromCountry

Description

To get state code from country and state

URL

https://api.rightwave.com/rdn/api/ss/getStateCodeFromCountry?country={Marketo token for country}&state={Marketo token for state}

Headers

 

Key Name

Value

Description

auth-key

62m-8db697ee26b6eb4e17876775 

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters

 

Parameter Name

Data Type

Description

country

String

first input for getStateCodeFromCountry

state

String

second input for getStateCodeFromCountry

Output

{

success (boolean) : Whether the request succeed or not,

input : {

country(String) : Contains the value of country as String,

state(String) : Contains the value of state as String

},

result : {

output(String) : Contains state code .

},

error : {

code(Int) : Error code on case of error,

message(String) : Message related to error code

},

requestId(String) : RequestId generated in RDN to track the search

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 62m-8db697ee26b6eb4e17876775’ \

“https://api.rightwave.com/rdn/api/ss/getStateCodeFromCountry?country=United States&state=Alaska”

 

4.43 Is ISP Domain

API Name

isISPDomain

Description

You can use this service to search for a domain. 

For example,

You have a string named domain with the value “163.com”.
The API will return a boolean value true.
You have a string named domain with the value “abc.com”.
The API will return a boolean value false.

URL

https://api.rightwave.com/rdn/api/ss/isISPDomain?domain={Marketo token for domain}

Headers


Key Name

Value

Description

auth-key

62m-8db697ee26b6eb4e17876775 

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

domain

String

input for isISPDomain

Output

{

success (boolean) : Whether the request succeed or not,

input : {

domain(string) : Contains the domain as String

},

result : {

output(String) : Contains True if it contains domain

},

error : {

code(Int) : Error code on case of error,

message(String) : Message related to error code

},

requestId(String) : RequestId generated in RDN to track the search

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 62m-8db697ee26b6eb4e17876775’ \

“https://api.rightwave.com/rdn/api/ss/isISPDomain?domain=mail.com”

4.44 Junk Score

API Name

Junk Score

Description

You can use the Junk Score service to assess the likelihood of a profile being genuine or potentially problematic based on various profile attributes such as first name, last name, email, company name, and job title.

The Junk Score service applies rules and algorithms based on various parameters:

  1. Data Validation: Checks for suspicious or irregular patterns in the provided information (e.g., random characters in the name fields, unusual email patterns).
  2. Comparison to Known Patterns: Compares the provided data with known patterns of junk profiles (e.g., commonly used disposable email domains, frequently used fake names).
  3. Algorithmic Scoring: Utilizes an algorithm to assign weighted scores to different profile attributes based on their relevance and susceptibility to being associated with junk profiles.

The Junk Score service generates an overall score (junk value) based on the applied rules and algorithms.

Scores range from 0 to 100:

  1. Junk score of 0 indicates a highly favorable, authentic profile.
  2. Junk score above 50 indicates a high likelihood of the profile being junk or problematic.
  3. Scores above 0 and below 50 signify a low/medium risk of the profile being potentially problematic or less genuine i.e. they can be reviewed.

URL

https://api.rightwave.com/rdn/api/ss/junkScore?inputfirstName={Marketo token for inputfirstName}& inputlastName={Marketo token for  inputlastName}& inputemail={Marketo token for  inputemail}& inputcompanyName={Marketo token for  inputcompanyName}& inputtitle={Marketo token for  inputtitle}

Headers


Key Name

Value

Description

auth-key

62m-8db697ee26b6eb4e17876775

Use for authentication

Content-Type

application/json

Header for Content-Type

Query Parameters


Parameter Name

Data Type

Description

inputfirstName

String

Input for junkScore

inputlastName

String

Input for junkScore

inputemail

String

Input for junkScore

inputcompanyName

String

Input for junkScore

inputtitle

String

Input for junkScore

Output

{

success (boolean) : Whether the request succeed or not,

input : {

inputfirstName : first name as string,

inputlastName : last name as string,

inputemail : email address as string,

inputcompanyName : company name as string,

inputtitle : title as string

},

result : {

output(number) : Contains a number that provides the junk score for the provided fields,

reasons : [object Object]

},

error : {

code(Int) : Error code on case of error,

message(String) : Message related to error code

},

requestId(String) : RequestId generated in RDN to track the search

}

Example

curl -X GET \

-H ‘Content-Type: application/json’ \

-H ‘auth-key: 62m-8db697ee26b6eb4e17876775’ \

“https://api.rightwave.com/rdn/api/ss/junkScore?inputfirstName=Geoff&inputlastName=Schmidt&inputemail=gschmidt@directdigitalholdings.com&inputcompanyName=Direct Digital Holdings&inputtitle=Other”