GeoClear Address API

Address verification, autocomplete, bulk, and proximity

GitHub OpenAPI

Operations 4

GET /api/address Address lookup and verification #
GET /api/suggest Address autocomplete / typeahead #
POST /api/address/bulk Bulk address verification (up to 1,000) #
GET /api/near Proximity search #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/geoclear-io:geoclear-io-address-api"
All apis
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.

Get an API 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 Specification

geoclear-io-address-api-openapi.yml Raw ↑
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