---
title: "Geocode Address"
method: POST
path: "/v1/geocode"
tags: ["geo"]
---

# Geocode Address

`POST /v1/geocode`

## Request

- Base URL: `https://api.actuato.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.actuato.com/v1/geocode`
- Auth: none declared

Resolve a US address to coordinates so forms and agents never need raw lat/lng.

## Request body

- GeocodeRequest: Either a free-text `address` or structured parts; at least a street or a ZIP is needed.
  - `address` string, nullable
  - `line1` string, nullable
  - `city` string, nullable
  - `region` string, nullable
  - `postal_code` string, nullable

## Response `200`

Successful Response

- GeocodeOut
  - `found` boolean, required
  - `location` LatLng
    - `lat` number, required
    - `lng` number, required
  - `matched_address` string, nullable
  - `address` Address
    - `line1` string, nullable
    - `line2` string, nullable
    - `city` string, required
    - `region` string, required: State / province code, e.g. MD
    - `postal_code` string, nullable
    - `country` string
  - `hint` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/actuato/apis/actuator-api.md) · [All operations](https://skmtc.dev/actuato/apis/actuator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/actuato/apis/actuator-api/revisions/67a742c2308b?raw)