GeoClear Address API
Address verification, autocomplete, bulk, and proximity
Address verification, autocomplete, bulk, and proximity
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/geoclear-io:geoclear-io-address-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Geoclear Io Address API
version: 1.0.0
contact:
name: GeoClear Support
url: https://geoclear.io
license:
name: Commercial
description: 'Operations tagged Address across 2 of this provider''s published API definitions: geoclear-io-dev-openapi.yaml, geoclear-io-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://geoclear.io
description: Production
security:
- ApiKeyHeader: []
- ApiKeyQuery: []
tags:
- name: Address
description: Address verification, autocomplete, bulk, and proximity
paths:
/api/address:
get:
deprecated: true
summary: Address lookup and verification
description: 'Verify and enrich a US address. Returns the matching address(es) with coordinates, neighborhood, county FIPS, timezone, residential flag, and confidence score.
Use `?fuzzy=true` for typo-tolerant matching ("Pensilvania Ave" finds "Pennsylvania Ave").'
tags:
- Address
parameters:
- name: street
in: query
description: Street name (e.g. "Pennsylvania Ave")
schema:
type: string
- name: number
in: query
description: House/building number (e.g. "1600")
schema:
type: string
- name: city
in: query
description: City name
schema:
type: string
- name: state
in: query
description: 2-letter state code (e.g. "DC")
schema:
type: string
- name: zip
in: query
description: ZIP code
schema:
type: string
- name: fuzzy
in: query
description: Enable typo-tolerant matching
schema:
type: boolean
default: false
- name: limit
in: query
description: Max results (default 20, max 100)
schema:
type: integer
default: 20
maximum: 100
responses:
'200':
description: Address results
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
data:
type: array
items:
$ref: '#/components/schemas/Address'
'401':
description: Invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
operationId: getApiAddress
x-operation-id-source: derived
servers:
- url: https://geoclear.io
description: Production
/api/suggest:
get:
deprecated: true
summary: Address autocomplete / typeahead
description: Returns up to 20 address suggestions matching the given prefix. Designed for live-as-you-type UX.
tags:
- Address
parameters:
- name: q
in: query
required: true
description: Address prefix (min 2 characters)
schema:
type: string
example: 1600 Penn
- name: state
in: query
description: Scope to a specific state
schema:
type: string
- name: zip
in: query
description: Scope to a specific ZIP code
schema:
type: string
- name: limit
in: query
schema:
type: integer
default: 10
maximum: 20
responses:
'200':
description: Autocomplete suggestions
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
data:
type: array
items:
$ref: '#/components/schemas/Address'
operationId: getApiSuggest
x-operation-id-source: derived
servers:
- url: https://geoclear.io
description: Production
/api/address/bulk:
post:
deprecated: true
summary: Bulk address verification (up to 1,000)
description: Verify and enrich up to 1,000 addresses in a single synchronous request.
tags:
- Address
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- addresses
properties:
addresses:
type: array
maxItems: 1000
items:
type: object
properties:
street:
type: string
number:
type: string
city:
type: string
state:
type: string
zip:
type: string
responses:
'200':
description: Bulk results
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
results:
type: array
items:
$ref: '#/components/schemas/Address'
operationId: postApiAddressBulk
x-operation-id-source: derived
servers:
- url: https://geoclear.io
description: Production
/api/near:
get:
deprecated: true
summary: Proximity search
description: Returns addresses within a given radius of a lat/lon coordinate.
tags:
- Address
parameters:
- name: lat
in: query
required: true
schema:
type: number
example: 38.8977
- name: lon
in: query
required: true
schema:
type: number
example: -77.0365
- name: radius_km
in: query
description: Search radius in kilometers (default 1.0)
schema:
type: number
default: 1.0
- name: limit
in: query
schema:
type: integer
default: 20
maximum: 500
responses:
'200':
description: Nearby addresses
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
data:
type: array
items:
$ref: '#/components/schemas/Address'
operationId: getApiNear
x-operation-id-source: derived
servers:
- url: https://geoclear.io
description: Production
components:
schemas:
Address:
type: object
properties:
id:
type: integer
nad_uuid:
type: string
description: Stable address record identifier
full_address:
type: string
example: 1600 Pennsylvania Ave NW, Washington, DC 20500
add_number:
type: string
example: '1600'
st_pre_dir:
type: string
example: NW
st_name:
type: string
example: Pennsylvania
st_pos_typ:
type: string
example: Ave
st_pos_dir:
type: string
unit:
type:
- string
- 'null'
inc_muni:
type: string
example: Washington
description: Incorporated municipality
post_city:
type: string
example: Washington
description: Postal city
county:
type: string
example: District of Columbia
state:
type: string
example: DC
zip_code:
type: string
example: '20500'
plus4:
type:
- string
- 'null'
latitude:
type: number
format: float
example: 38.8977
longitude:
type: number
format: float
example: -77.0365
addr_type:
type: string
example: Building
addr_class:
type: string
example: Numbered Thoroughfare Address
placement:
type: string
example: Rooftop
county_fips:
type: string
example: '11001'
description: 5-digit county FIPS code
timezone:
type: string
example: America/New_York
residential:
type: boolean
confidence:
type: integer
minimum: 0
maximum: 100
example: 95
Error:
type: object
properties:
ok:
type: boolean
example: false
error:
type: string
example: Invalid or revoked API key.
securitySchemes:
ApiKeyHeader:
type: apiKey
in: header
name: X-Api-Key
ApiKeyQuery:
type: apiKey
in: query
name: key
x-refined-from:
- geoclear-io-dev-openapi.yaml
- geoclear-io-openapi.yaml