Location Reverse GeoCoding

Convert latitude and longitude to an approximate address (reverse geocoding). Use to validate or display user location.

Request

GET/api/v1/kyc/address/reverse_geocode

{{baseUrl}}/api/v1/kyc/address/reverse_geocode

Header

Header	Type	Description
Authorization	string	`Bearer YOUR_ACCESS_TOKEN` from the OAuth client-credentials flow
Content-Type	string	application/json

Query Parameters

Parameter	Type	Description	Required
longitude	string	longtitude of location	required
latitude	string	latitude of the location	required

Response

200 OKSample dataExample response

{
  "entity": {
    "address_components": {
      "plus_code": "",
      "premise": "",
      "street_number": "2647",
      "route": "21st Street",
      "locality": "San Francisco",
      "postal_town": "",
      "administrative_area_level_2": "San Francisco County",
      "administrative_area_level_1": "California",
      "country": "United States",
      "postal_code": "94110",
      "neighborhood": "Mission District"
    },
    "formatted_address": "2647 21st St, San Francisco, CA 94110, USA"
  }
}

Response Fields

Field	Type	Description
entity	object	Contains the response data
entity.address_components	object	Breakdown of the address into individual components
entity.address_components.plus_code	string	Google Plus Code for the location
entity.address_components.premise	string	Building or premise name
entity.address_components.street_number	string	Street number of the address
entity.address_components.route	string	Street or road name
entity.address_components.locality	string	City or locality name
entity.address_components.postal_town	string	Postal town name
entity.address_components.administrative_area_level_2	string	County or second-level administrative area
entity.address_components.administrative_area_level_1	string	State or first-level administrative area
entity.address_components.country	string	Country name
entity.address_components.postal_code	string	Postal/ZIP code
entity.address_components.neighborhood	string	Neighborhood name
entity.formatted_address	string	Human-readable address string

Set {{baseUrl}} to https://api.peleza.com (production) or https://sandbox.peleza.com (sandbox). Authenticated calls need a Bearer token from POST /api/v1/oauth/token.