---
title: "POST /api/v3/locations/nearest"
method: POST
path: "/api/v3/locations/nearest"
tags: ["locations"]
---

# POST /api/v3/locations/nearest

`POST /api/v3/locations/nearest`

Location viewset.

## Request body

- NearestRequest
  - `address` string, required — String address of the location
  - `includeP99` boolean — p99 represents the network of point99. If you set it to true, the nearests p99 place locations will be returned. Otherwise, only will be returned the location according to the giving address.
  - `distance` integer — Maximum distance in meters between the given direction and the nearest p99
  - `city` string, required — City of the address
  - `country` string, required — Country of the address

## Response `200`

- NearestResponse
  - `message` string, required
  - `traceId` string, uuid, required
  - `data` NearestList[], required
    - `description` string, required — Description of the location
    - `address` string, required — String address of the location
    - `latitude` string, required — Lattitude of the location
    - `longitude` string, required — Longitude of the location
    - `locationId` string, uuid, required — Unique uuid for the location. This id can be used to refer an origin or destination in the order creation endpoint.
    - `locationType` 'p99_network' | 'private', required
    - `distance` number, double, required — Distance to the given address.
    - `zipcode` string, required — Zipcode address
  - `next` string, uri, required
  - `previous` string, uri, required
  - `errors` object, required

---

[API](https://skmtc.dev/99minutos/apis/api-version-3.md) · [All operations](https://skmtc.dev/99minutos/apis/api-version-3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/99minutos/api-version-3/revisions/3eca3996fd97/schema)