Skip to main content
POST
/
reverse-geocoding
Reverse Geocoding
curl --request POST \
  --url https://sandbox.cashfree.com/verification/reverse-geocoding \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '
{
  "verification_id": "test001",
  "latitude": "12.9274477",
  "longitude": "77.6326542"
}
'
{
  "verification_id": "test001",
  "reference_id": 21637861,
  "latitude": "12.9274477",
  "longitude": "77.6326542",
  "address": "JSS Institutions Campus, First Floor, CA Site No.1, HAL 3rd Stage, HAL 3rd Stage, KodihalliBehind Hotel Leela Palace, HAL 2nd Stage, Kodihalli, Bengaluru, Karnataka 560008, India",
  "city": "bangalore",
  "state": "Karnataka",
  "statecode": "KA",
  "countrycode": "In",
  "pincode": "560008",
  "status": "VALID"
}

Authorizations

​
x-client-id
string
header
required

Your unique client identifier issued by Cashfree. You can find this in your Merchant Dashboard.

​
x-client-secret
string
header
required

The secret key associated with your client ID. Use this to authenticate your API requests. You can find this in your Merchant Dashboard.

Headers

​
x-cf-signature
string

Send the signature if two-factor authentication is selected as Public Key. More details

Body

application/json

Find the request parameters to retrieve the physical address of a location

​
verification_id
string
default:test001
required

It is the unique ID you create to identify the verification request. The maximum character limit is 50. Only alphanumeric, period (.), hyphen (-), and underscore ( _ ) are allowed.

Example:

"test001"

​
latitude
string
default:12.9274477
required

It is the angular distance expressed in degrees of arc north or south of the equator to specify the location.

Example:

"12.9274477"

​
longitude
string
default:77.6326542
required

It is the angular distance expressed in degrees of arc east or west of the equator to specify the location.

Example:

"77.6326542"

Response

Success response for retrieving physical address of a location

​
reference_id
integer

It displays the unique ID created by Cashfree Payments for reference purposes. format: int64

Example:

21637861

​
verification_id
string

It displays the unique ID you created to identify the verification request.

Example:

"test001"

​
latitude
string

It displays the entered angular distance expressed in degrees of arc north or south of the equator to specify the location.

Example:

"12.9274477"

​
longitude
string

It displays the entered angular distance expressed in degrees of arc east or west of the equator to specify the location.

Example:

"77.6326542"

​
address
string

It displays the physical address of the entered coordinates.

Example:

"JSS Institutions Campus, First Floor, CA Site No.1, HAL 3rd Stage, HAL 3rd Stage, KodihalliBehind Hotel Leela Palace, HAL 2nd Stage, Kodihalli, Bengaluru, Karnataka 560008, India"

​
city
string

It displays the name of the city of the entered coordinates.

Example:

"bangalore"

​
state
string

It displays the name of the state of the entered coordinates.

Example:

"Karnataka"

​
statecode
string

It displays the state's code of the entered coordinates.

Example:

"KA"

​
countrycode
string

It displays the country's code of the entered coordinates.

Example:

"In"

​
pincode
string

It displays the PIN code information of the entered coordinates.

Example:

"560008"

​
status
string

It displays the status of the entered coordinates. Possible values are:

  • VALID
Example:

"VALID"