> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dojah.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Location Reverse GeoCoding

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

### Request

```http [GET] theme={null}
{{baseUrl}}/api/v1/kyc/address/reverse_geocode
```

### Header

| Header        | Type   | Description                                                                                         |
| ------------- | ------ | --------------------------------------------------------------------------------------------------- |
| AppId         | string | Create an app to get your app ID on dashboard [here](https://app.dojah.io/developers/configuration) |
| Authorization | string | Private/secret key. Use `<key>` not `Bearer <key>`                                                  |

### Query Parameters

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

### Response

```json Response theme={null}
{
    "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 or ZIP code                                  |
| entity.address\_components.neighborhood                   | string | Neighborhood name                                   |
| entity.formatted\_address                                 | string | Full formatted address string                       |