---
title: "Find an address on the map"
method: GET
path: "/find-leads/geocode/"
tags: ["find-leads"]
---

# Find an address on the map

`GET /find-leads/geocode/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/find-leads/geocode/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Resolve one address to the point a radius search would centre on, so a builder can show where it is and how far the radius reaches before anything is searched. Free to call, and answers from a thirty-day cache for an address that has been asked before. An address that matches nothing comes back as a filter complaint against `area`, the same refusal a search would give. Results are Google Maps data: any surface that displays them must credit “Google Maps”.

## Query parameters

- `address` string, required: A street address, neighbourhood, postcode or city.

## Response `200`

Successful Response

- GeocodedAddressResponseSchema: Where an address is, so a builder can show the circle before it searches. Carries the address back with the point. The caller is a box the user is still typing in, and an answer that arrives after the text has moved on is only safe to draw if it says which text it answers.
  - `address` string, required: The address that was resolved, trimmed. Echoed back so a late answer can be told from a current one.
  - `latitude` number, required: Degrees north, between -90 and 90.
  - `longitude` number, required: Degrees east, between -180 and 180.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: The address matched nothing, or the geocoder could not be reached.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)