---
title: "Resolve a location to coordinates; return candidates rather than guess"
method: GET
path: "/locations"
tags: ["WellFred public API"]
---

# Resolve a location to coordinates; return candidates rather than guess

`GET /locations`

## Request

- Base URL: `https://app.wellfred.com/api/agent`
- URL: `https://app.wellfred.com/api/agent/locations`
- Auth: none declared

## Query parameters

- `query` string, nullable

## Response `200`

- object
  - `success` boolean, required
  - `message` string, required
  - `locations` object[], required
    - `id` string, required
    - `name` string, required
    - `nameEs` string, required
    - `province` string, required
    - `lat` number, required: zones.center_lat/lng are NOT NULL decimals cast to float — a zone always knows where it is.
    - `lng` number, required
  - `provinces` object[], required
    - `id` string, required
    - `name` string, required
    - `nameEs` string, required
    - `countryCode` 'CR', required

## Other responses

- `422`: Validation error

---

[API](https://skmtc.dev/wellfred/apis/wellfred-api.md) · [All operations](https://skmtc.dev/wellfred/apis/wellfred-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wellfred/apis/wellfred-api/revisions/5a6665793917?raw)