---
title: "Resolve a place, region, or postal code, or validate US coordinates"
method: GET
path: "/v1/locations/resolve"
tags: ["Discovery"]
---

# Resolve a place, region, or postal code, or validate US coordinates

`GET /v1/locations/resolve`

## Request

- Base URL: `https://api.carhandshake.com`
- URL: `https://api.carhandshake.com/v1/locations/resolve`
- Auth: none required

Choose one country (US by default), then supply free-text location. Raw coordinates are supported only for US; Canadian callers must use a postal code/FSA or supported place because authoritative province containment is not available. Quebec is unavailable.

## Query parameters

- `country` 'US' | 'CA'
- `location` string
- `latitude` number
- `longitude` number

## Response `200`

Resolved in-market location

- union
  - TextLocationResolution
    - `input` string, required
    - `normalized_input` string, required
    - `resolved` ResolvedLocationScope, required
      - `kind` 'postal' | 'place' | 'region', required
      - `country` 'US' | 'CA', required
      - `region_code` string, required
      - `place_name` string
      - `postal_code` string
      - `label` string, required
      - `latitude` number, required
      - `longitude` number, required
      - `confidence` number, required
      - `inventory_count` integer, required
    - `candidates` ResolvedLocationScope[], required
      - `kind` 'postal' | 'place' | 'region', required
      - `country` 'US' | 'CA', required
      - `region_code` string, required
      - `place_name` string
      - `postal_code` string
      - `label` string, required
      - `latitude` number, required
      - `longitude` number, required
      - `confidence` number, required
      - `inventory_count` integer, required
  - CoordinateLocationResolution
    - `input` object, required
      - `latitude` number, required
      - `longitude` number, required
    - `resolved` object, required
      - `country` 'US', required
      - `latitude` number, required
      - `longitude` number, required
      - `precision` 'provided_coordinate', required

## Other responses

- `400`: RFC 9457 problem details

---

[API](https://skmtc.dev/carhandshake/apis/car-handshake-inventory-api.md) · [All operations](https://skmtc.dev/carhandshake/apis/car-handshake-inventory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carhandshake/apis/car-handshake-inventory-api/revisions/0a85bfd1c565?raw)