---
title: "Returns com.precisely.geolocation for a Wifi access point"
method: POST
path: "/v1/geolocation/access-point"
tags: ["Geolocation"]
---

# Returns com.precisely.geolocation for a Wifi access point

`POST /v1/geolocation/access-point`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v1/geolocation/access-point`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

The Geolocation Wifi Access end point provides the com.precisely.geolocation details.

## Headers

- `X-Request-Id` string

## Request body

- WiFiAccessPointRequest: Represents a request containing WiFi access point information, including serving and other cells.
  - `servingCell` ServingCellRequest, required: Represents the serving cell in a WiFi network, including details such as MAC address, SSID, RSSI, and speed.
    - `mac` string, required: MAC address of the WiFi access point.
    - `ssid` string, nullable: SSID (Service Set Identifier) of the WiFi network.
    - `rssi` string, nullable: RSSI (Received Signal Strength Indicator) value in dBm, representing signal strength.
    - `speed` string, nullable: The speed of the WiFi network in Mbps.
  - `otherCells` OtherCellRequest[], nullable: Optional list of other detected WiFi access points.
    - `mac` string, required: Unique MAC address identifying the WiFi access point.
    - `ssid` string, nullable: SSID (Service Set Identifier) of the WiFi network, representing the network name.
    - `rssi` string, nullable: RSSI (Received Signal Strength Indicator) in dBm, showing the signal strength of the access point.
    - `speed` string, nullable: Speed of the WiFi network in Mbps.

## Response `200`

WiFi access point com.precisely.geolocation fetched successfully

- GeolocationWiFiApiResponse: Response for the HTTP Geolocation WiFi API.
  - `response` GeolocationWiFiResponse: Response containing the status and result of the WiFi-based com.precisely.geolocation request.
    - `status` 'OK' | 'ZERO_RESULTS', required: Represents the status of a response
    - `result` WiFiAccessPointResult: Represents the result of a WiFi com.precisely.geolocation request, including the geometry of the location.
      - `geometry` WiFiGeometryResult, required: Represents the geometric details of the com.precisely.geolocation result, including type, coordinates, and accuracy.
        - `type` string, required: Type of the geometry object, typically 'Point'.
        - `coordinates` number[], required: A list of coordinates representing the location. The first value is longitude, and the second is latitude.
        - `accuracy` Accuracy, required: Represents the accuracy of the location data in terms of units and value.
          - `unit` string, required: The unit of measurement for the accuracy, typically in 'meters'.
          - `value` string, required: The value of the accuracy, representing the radius within which the location is accurate.

## Other responses

- `400`: The request could not be processed due to invalid or missing parameters. Ensure that all required fields are provided in the correct format.
- `401`: Authentication failed or access token is missing. Ensure you provide a valid bearer token in the request header.
- `403`: You do not have permission to access this resource. Ensure your API key or token has the correct permissions.
- `429`: Rate limit exceeded. Please wait before making more requests.
- `500`: An internal server error occurred. Please try again later or contact support if the issue persists.
- `503`: The service is temporarily unavailable. Please try again later.

---

[API](https://skmtc.dev/precisely/apis/third-party-api-service.md) · [All operations](https://skmtc.dev/precisely/apis/third-party-api-service/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/third-party-api-service/revisions/cf792ff5cabd?raw)