---
title: "GetLocationFromWifiNetworks"
method: POST
path: "/location/wifi"
tags: ["Wi-Fi Location"]
---

# GetLocationFromWifiNetworks

`POST /location/wifi`

<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/wifi</code></p>
<p><b>Device-to-cloud — authorize with a JSON Web Token.</b><br><code>https://api.location.nrfcloud.com/v1/location/wifi</code></p>
</div>

<div style="background-color: #fff3cd; color: #856404; text-align: center; border: 1px solid #ffeeba; border-radius: .25rem; padding: .75rem 1.25rem">This endpoint has an alternative. See the <a href="#tag/Ground-Fix">ground fix endpoint</a> for more details.</div>
Get location based on nearby Wi-Fi networks. At least two access points with valid MAC addresses are required. An empty `accessPoints` array is treated the same as an omitted field.

## Query parameters

- `doReply` union — Controls the response body. If boolean false or number 0, response body will be empty.
  - boolean
  - number, double
- `hiConf` boolean — nRF Cloud automatically uses a 68% confidence interval when estimating the Horizontal Positioning Error (HPE) for a location. This means that there is a 68% probability that the device's actual location is within the HPE radius of the returned coordinates. Enabling this flag will use a 95% confidence interval instead, resulting in a larger HPE radius, and a higher probability that the device's actual location is within the circle.

## 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.

## Request body

- WifiAccessPointsRequest
  - `accessPoints` AccessPoint[], required
    - union
      - AccessPointWithFrequency
        - `macAddress` string, required — String comprised of 6 hexadecimal pairs, separated by colons or dashes. When used in a positioning request, it must be universally assigned. See <a href="https://docs.nordicsemi.com/bundle/nrf-cloud/page/LocationServices/Guides/LocationTroubleshooting.html#my-wi-fi-request-returns-the-error-mac-address-mac-is-a-local-mac-address" target="_blank">this help page</a> for details.
        - `ssid` string
        - `signalStrength` number, double — Signal strength in dBm, between -128 and 0
        - `age` number, double — The number of milliseconds since this access point was detected.
        - `signalToNoiseRatio` number, double — The current signal to noise ratio measured in dB.
        - `frequency` number, double — Channel frequency in MHz
      - AccessPointWithChannel
        - `macAddress` string, required — String comprised of 6 hexadecimal pairs, separated by colons or dashes. When used in a positioning request, it must be universally assigned. See <a href="https://docs.nordicsemi.com/bundle/nrf-cloud/page/LocationServices/Guides/LocationTroubleshooting.html#my-wi-fi-request-returns-the-error-mac-address-mac-is-a-local-mac-address" target="_blank">this help page</a> for details.
        - `ssid` string
        - `signalStrength` number, double — Signal strength in dBm, between -128 and 0
        - `age` number, double — The number of milliseconds since this access point was detected.
        - `signalToNoiseRatio` number, double — The current signal to noise ratio measured in dB.
        - `channel` number, double

## Response `200`

Returns lat/lon coordinates and uncertainty for a device using nearby Wi-Fi networks

- WifiResponse
  - `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).

---

[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)