---
title: "Geocode Address"
method: GET
path: "/api/v1/search/geocode"
---

# Geocode Address

`GET /api/v1/search/geocode`

## Request

- Base URL: `https://trovastorage.it` (the document declares no server; this is the origin it was published from)
- URL: `https://trovastorage.it/api/v1/search/geocode`
- Auth: one of:
  - API key in header `X-Access-Token`
  - HTTP bearer

Resolve a free-text address to coordinates for the client map search.
Reuses the server-side geocoder (Nominatim in prod, deterministic stub in tests).

`bbox` is the extent of the place when what was typed is a town or a
district rather than an address, and null otherwise: the map opens on the
whole of "Milano", and on a neighbourhood around "via Tortona 12".

## Query parameters

- `q` string, required

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/trovastorage/apis/stock-your-inventory.md) · [All operations](https://skmtc.dev/trovastorage/apis/stock-your-inventory/llms.txt) · [OpenAPI document](https://skmtc.dev/trovastorage/apis/stock-your-inventory/revisions/c75f591a585c?raw)