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.
openapi: 3.2.0
info:
title: GoCodebook Topics 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: Topics
paths:
/v1/topics:
get:
summary: Topic ids (reserved; topic filters are not available yet)
responses:
'200':
description: List
tags:
- Topics
operationId: getV1Topics
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.