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. By signing up you are subscribing to the APIs.io and API Evangelist
newsletters — you can unsubscribe from any issue. See our
Privacy Policy and Terms.
openapi: 3.2.0
info:
title: Nearby Permits Near API
version: 0.1.0
description: 'Building permits by address from US city open data. The API is free and read-only. The JSON API needs a free key from https://nearbypermits.com/developers/#key. Each key gets 10,000 calls a day; send it as "Authorization: Bearer " or add ?key= to the URL. Search engines and AI answer bots that we can check against their published IP addresses need no key and have no limit. The MCP server needs no key: each IP address gets 200 tool calls a day, or 10,000 with a key sent as an Authorization header. A JSON API call without a key is refused. Over the limit, the API answers 429 with a JSON body and a Link header to https://nearbypermits.com/developers/#key. Counts start again at midnight UTC.'
servers:
- url: https://nearbypermits.com
security:
- bearerKey: []
- queryKey: []
tags:
- name: Near
paths:
/v1/near:
get:
operationId: permitsNear
summary: Permits within a radius of an address or a point, newest first, with distance…
description: Give city and address, or lat and lon. Nearby permits come from the last 24 months of city data. counts.total is exact even when the list is capped by limit.
parameters:
- name: city
in: query
required: false
schema:
type: string
enum:
- los-angeles
- new-york
- chicago
- san-francisco
- seattle
- austin
- cincinnati
- mesa
- new-orleans
- fort-worth
- columbus
- san-diego
- detroit
- nashville
- raleigh
- phoenix
- san-antonio
- minneapolis
- montgomery-county-md
- boston
- pittsburgh
- washington-dc
- denver
- los-angeles-county
- wake-county
- miami
- miami-dade-county
- hillsborough-county
- cape-coral
- port-st-lucie
- alachua-county
- kansas-city
- baltimore
- sacramento-county
- memphis
- las-vegas
- tacoma
- boulder
- cambridge
- somerville
- marin-county
- pierce-county
- cary
- cleveland
- arlington-tx
- naperville
- tempe
- anaheim
- riverside
- name: address
in: query
schema:
type: string
maxLength: 120
example: 2443 W Warren Blvd
- name: lat
in: query
schema:
type: number
- name: lon
in: query
schema:
type: number
- name: radius_m
in: query
schema:
type: integer
minimum: 50
maximum: 1600
default: 400
- name: since
in: query
schema:
type: string
description: YYYY-MM-DD, or 6m, 1y, 2y (default 6m)
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 200
default: 50
- name: format
in: query
schema:
type: string
enum:
- json
- geojson
responses:
'200':
description: story ({kind, text} or null), answer, center, radius_m, since, at_address, permits (each with distance_m, bearing, group), counts, freshness, source. A loosely typed address is matched as on /v1/address; when more than one matches, found is false and did_you_mean lists them.
'400':
description: Bad input
'401':
description: The key is missing or isn't valid. The body says where to get a free key.
'403':
description: No key was sent.
'429':
description: This key reached its daily limit. The body says how to ask for a higher one, and Retry-After gives the seconds to midnight UTC.
tags:
- Near
components:
securitySchemes:
bearerKey:
type: http
scheme: bearer
description: Free key from https://nearbypermits.com/developers/#key
queryKey:
type: apiKey
in: query
name: key