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 Cities 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: Cities
paths:
/v1/cities:
get:
operationId: listCities
summary: Supported cities
responses:
'200':
description: Cities
'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:
- Cities
components:
securitySchemes:
bearerKey:
type: http
scheme: bearer
description: Free key from https://nearbypermits.com/developers/#key
queryKey:
type: apiKey
in: query
name: key