---
title: "GetAddressDataFromCoordinates"
method: GET
path: "/location/geo"
tags: ["Geocoding"]
---

# GetAddressDataFromCoordinates

`GET /location/geo`

<div class="nrf-note">
<p><b>Cloud-to-cloud — authorize with an Organization Auth Token.</b><br><code>https://api.location.nrfcloud.com/v1/organizations/{organizationSlug}/projects/{projectSlug}/location/geo</code></p>
<p><b>Device-to-cloud — authorize with a JSON Web Token.</b><br><code>https://api.location.nrfcloud.com/v1/location/geo</code></p>
</div>

Convert a set of WGS 84 coordinates into a physical address. Only country and state/province/region are guaranteed.
Higher accuracy properties (street number, street, etc) are provided when available.

A 404 status code (not found) will be returned if nRF Cloud cannot determine at least country and state/province/region for the provided
coordinates.

nRF Cloud returns the address data closest to the submitted coordinates. Coordinates from a higher-density urban areas generally
provide better results. Coordinates from rural areas may return address data further away from the submitted coordinates. The system
returns an uncertainty property, which is the distance in meters away from the submitted coordinates.

Coordinates obtained with a high-accuracy method (GNSS / Wi-Fi) will provide address data closer to the actual device location
than coordinates obtained with lower-accuracy methods like cellular.

```sh
curl --location --request GET "$API_HOST/v1/location/geo?lat=45.524098&lon=-122.688408" \
--header "Authorization: Bearer $JWT" \
--header "Content-Type: application/json"
```

## Query parameters

- `lat` number, double, required — WGS 84 geodetic grid line, north to south.
- `lon` number, double, required — WGS 84 geodetic grid line, east to west.

## Headers

- `x-custom-device-id` string — User-defined device ID, used to identify requests when using a cloud-to-cloud integration. Ignored if using a device token.

## Response `200`

Returns address data for a set of WGS 84 coordinates.

- ReverseGeoResponse
  - `lat` number, double, required — WGS 84 geodetic grid line, north to south.
  - `lon` number, double, required — WGS 84 geodetic grid line, east to west.
  - `uncertainty` number, double, required — Radius of the uncertainty circle around the location in meters. Also known as Horizontal Positioning Error (HPE).
  - `formatted` string, required — Description of the address, created from values in the 'address' property
  - `address` ReverseGeoAddress, required
    - `country` string, required — Country
    - `state` string, required — State, province, or region.
    - `countryCode` string — Country Code - 2 letter (ISO 3166-1 alpha-2)
    - `county` string — Geographic region in a country
    - `postalCode` string — Postcode, PIN, zip code
    - `stateCode` string — State or province code
    - `city` string — City, town, municipality, borough, hamlet
    - `suburb` string — Geographic region used for residential and commercial purposes
    - `street` string — Road, pathway, motorway, highway
    - `streetNumber` string — House or building number

---

[API](https://skmtc.dev/nrfcloud/apis/nrf-cloud-rest-api.md) · [All operations](https://skmtc.dev/nrfcloud/apis/nrf-cloud-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nrfcloud/nrf-cloud-rest-api/revisions/c4e56e458ebf/schema)