Geography & Location

getCleanCountryName

You can use this service to get a clean country name from a raw country value. For example, "AF" → "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": true,
	"input": {
		"rawCountry": "AF"
	},
	"result": {
		"output": "Afghanistan"
	},
	"requestId": "21666676345885609"
}

Example:

curl -X GET \
-H 'Content-Type: application/json' \
-H 'auth-key: 62m-8db697ee26b6eb4e17876775' \
"https://api.rightwave.com/rdn/api/ss/getCleanCountryName?rawCountry=AF"

---

getStateCodeFromCountry

To get the state code from a country and state. For example, country "United States" and state "Alaska" → state code "AK".

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": true,
	"input": {
		"country": "United States",
		"state": "Alaska"
	},
	"result": {
		"output": "AK"
	},
	"requestId": "21666676345885609"
}

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"

---

Get IP Details

The Get Lead IP Details service gives us demographic information about the leads. It accepts the IPv4 format of IP address.

URL:

https://api.rw001.com/rdn/api/ss/getLeadIPDetails?ip={Marketo token for ip}

Headers:

Key Name	Value	Description
auth-key	6tv-8c34fa6bb63d3ad59cff6467	Use for authentication
Content-Type	application/json	accept application/json

Query Parameters:

Parameter Name	Data Type	Description
ip	String	Valid IPv4 address

Output:

{
	"success": true,
	"input": {
		"input": "117.217.15.6"
	},
	"result": {
		"output": {
			"ip": "117.217.15.6",
			"country": "India",
			"country_code": "IN",
			"state": "West Bengal",
			"state_code": "WB",
			"city": "Dalkhola",
			"isisp": "Y",
			"latitude": "25.8719",
			"longitude": "87.8358",
			"zip": "733201",
			"organization": "BSNL"
		}
	},
	"requestId": "21666676345885609"
}

Example:

curl -X GET \
-H 'Content-Type: application/json' \
-H 'auth-key: 6tv-8c34fa6bb63d3ad59cff6467' \
"https://api.rw001.com/rdn/api/adv/getLeadIPDetails?ip=117.217.15.6"