The Jurisdictions API from GoCodebook — 2 operation(s) for jurisdictions.
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/gocodebook-com:gocodebook-com-jurisdictions-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: GoCodebook Jurisdictions API
version: 1.0.0
description: 'Search California local ordinances (city and county codes) and, with an API key, California state law, Title 24 building codes and federal law, and get structured results with verbatim excerpts, citations and links.
**Free sample** — no key, rate-limited per address, local ordinances only, no AI overview.
**Paid access** — send an API key (`Authorization: Bearer gcb_live_…`). Adds the `subnational` layer (California statutes, regulations, rent control, state guidance and Title 24 building codes, as excerpts) and the `national` layer (federal statutes and regulations, HUD guidance) through `filters.layers`. $0.30 a search with the AI overview included, drawn from a prepaid balance; a search with no results is not charged. `gcb_test_…` keys are free and rate-limited. Pricing, keys and limits: https://gocodebook.com/developers
Requests, including query text, are stored. Results are code text, not legal advice.'
servers:
- url: https://gocodebook.com/api
- url: https://api.gocodebook.com
description: Dedicated API host (same API).
security:
- {}
- apiKey: []
tags:
- name: Jurisdictions
paths:
/v1/jurisdictions:
get:
summary: List California cities and counties
parameters:
- name: q
in: query
schema:
type: string
description: Name contains.
- name: level
in: query
schema:
type: string
enum:
- county
- municipal
- name: limit
in: query
schema:
type: integer
maximum: 1000
default: 100
responses:
'200':
description: List of jurisdictions
'400':
description: Invalid request
content:
application/json:
schema:
type: object
required:
- error
- request_id
properties:
error:
type: object
required:
- type
- code
- message
properties:
type:
type: string
enum:
- invalid_request
- authentication
- permission
- billing
- rate_limited
- not_found
- api_error
code:
type: string
message:
type: string
param:
type:
- string
- 'null'
docs:
type: string
request_id:
type: string
'401':
description: Invalid or revoked API key
content:
application/json:
schema:
type: object
required:
- error
- request_id
properties:
error:
type: object
required:
- type
- code
- message
properties:
type:
type: string
enum:
- invalid_request
- authentication
- permission
- billing
- rate_limited
- not_found
- api_error
code:
type: string
message:
type: string
param:
type:
- string
- 'null'
docs:
type: string
request_id:
type: string
'402':
description: Insufficient prepaid balance, or an invoiced account's monthly cap
content:
application/json:
schema:
type: object
required:
- error
- request_id
properties:
error:
type: object
required:
- type
- code
- message
properties:
type:
type: string
enum:
- invalid_request
- authentication
- permission
- billing
- rate_limited
- not_found
- api_error
code:
type: string
message:
type: string
param:
type:
- string
- 'null'
docs:
type: string
request_id:
type: string
'403':
description: Needs paid access or a feature not enabled (e.g. the AI overview)
content:
application/json:
schema:
type: object
required:
- error
- request_id
properties:
error:
type: object
required:
- type
- code
- message
properties:
type:
type: string
enum:
- invalid_request
- authentication
- permission
- billing
- rate_limited
- not_found
- api_error
code:
type: string
message:
type: string
param:
type:
- string
- 'null'
docs:
type: string
request_id:
type: string
'429':
description: Rate limited. See Retry-After.
content:
application/json:
schema:
type: object
required:
- error
- request_id
properties:
error:
type: object
required:
- type
- code
- message
properties:
type:
type: string
enum:
- invalid_request
- authentication
- permission
- billing
- rate_limited
- not_found
- api_error
code:
type: string
message:
type: string
param:
type:
- string
- 'null'
docs:
type: string
request_id:
type: string
'503':
description: Temporarily unavailable. Nothing ran.
content:
application/json:
schema:
type: object
required:
- error
- request_id
properties:
error:
type: object
required:
- type
- code
- message
properties:
type:
type: string
enum:
- invalid_request
- authentication
- permission
- billing
- rate_limited
- not_found
- api_error
code:
type: string
message:
type: string
param:
type:
- string
- 'null'
docs:
type: string
request_id:
type: string
tags:
- Jurisdictions
operationId: getV1Jurisdictions
x-operation-id-source: derived
/v1/jurisdictions/{id}:
get:
summary: 'One jurisdiction and the codes held for it (`us-ca`: the state documents; `us`…'
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: limit
in: query
description: '`us` only: documents listed, 1–1000 (default 100). `document_count` gives the whole.'
schema:
type: integer
responses:
'200':
description: Jurisdiction
'400':
description: Invalid request
content:
application/json:
schema:
type: object
required:
- error
- request_id
properties:
error:
type: object
required:
- type
- code
- message
properties:
type:
type: string
enum:
- invalid_request
- authentication
- permission
- billing
- rate_limited
- not_found
- api_error
code:
type: string
message:
type: string
param:
type:
- string
- 'null'
docs:
type: string
request_id:
type: string
'401':
description: Invalid or revoked API key
content:
application/json:
schema:
type: object
required:
- error
- request_id
properties:
error:
type: object
required:
- type
- code
- message
properties:
type:
type: string
enum:
- invalid_request
- authentication
- permission
- billing
- rate_limited
- not_found
- api_error
code:
type: string
message:
type: string
param:
type:
- string
- 'null'
docs:
type: string
request_id:
type: string
'402':
description: Insufficient prepaid balance, or an invoiced account's monthly cap
content:
application/json:
schema:
type: object
required:
- error
- request_id
properties:
error:
type: object
required:
- type
- code
- message
properties:
type:
type: string
enum:
- invalid_request
- authentication
- permission
- billing
- rate_limited
- not_found
- api_error
code:
type: string
message:
type: string
param:
type:
- string
- 'null'
docs:
type: string
request_id:
type: string
'403':
description: Needs paid access or a feature not enabled (e.g. the AI overview)
content:
application/json:
schema:
type: object
required:
- error
- request_id
properties:
error:
type: object
required:
- type
- code
- message
properties:
type:
type: string
enum:
- invalid_request
- authentication
- permission
- billing
- rate_limited
- not_found
- api_error
code:
type: string
message:
type: string
param:
type:
- string
- 'null'
docs:
type: string
request_id:
type: string
'404':
description: Not covered
'429':
description: Rate limited. See Retry-After.
content:
application/json:
schema:
type: object
required:
- error
- request_id
properties:
error:
type: object
required:
- type
- code
- message
properties:
type:
type: string
enum:
- invalid_request
- authentication
- permission
- billing
- rate_limited
- not_found
- api_error
code:
type: string
message:
type: string
param:
type:
- string
- 'null'
docs:
type: string
request_id:
type: string
'503':
description: Temporarily unavailable. Nothing ran.
content:
application/json:
schema:
type: object
required:
- error
- request_id
properties:
error:
type: object
required:
- type
- code
- message
properties:
type:
type: string
enum:
- invalid_request
- authentication
- permission
- billing
- rate_limited
- not_found
- api_error
code:
type: string
message:
type: string
param:
type:
- string
- 'null'
docs:
type: string
request_id:
type: string
tags:
- Jurisdictions
operationId: getV1JurisdictionsById
x-operation-id-source: derived
components:
securitySchemes:
apiKey:
type: http
scheme: bearer
description: Optional. gcb_live_… or gcb_test_… keys, created by an organization owner or admin. Without a key, requests run on the free sample tier.