CityCode API

Minneapolis Code of Ordinances, for your agents

Grounded, citation-backed answers over Minneapolis Code of Ordinances — as a single authenticated POST. Build it into any agent in minutes. Start free, subscribe when you scale.

Get an API key View OpenAPI

One request

curl -X POST https://citycodeassistant.com/api/v1/citycode/query \
  -H "Authorization: Bearer cck_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"question": "What is the maximum height for a detached accessory structure?"}'

Pricing

Free

Start building in minutes.

25 API queries / day
Grounded, citation-backed answers
Full OpenAPI spec
For evaluation & low volume

Get a key

Pro

Unlimited queries · billed monthly.

Unlimited API queries
Grounded, citation-backed answers
Priority throughput
Self-serve billing & invoices

Price shown at checkout.

Reference

Authentication

Pass your key as a bearer token: Authorization: Bearer cck_live_…. Keys are created and revoked in your dashboard. The full key is shown once at creation — store it securely.

Endpoints

POST	/api/v1/citycode/query	Ask a municipal-code question (auth required).
GET	/api/v1/citycode/health	Liveness probe (no auth).
GET	/api/v1/citycode/openapi.json	Machine-readable OpenAPI 3.1 spec.

Errors

401 unauthorized	Missing or invalid API key.
400 validation_error	Body missing `question` or it exceeds 2000 chars.
429 RATE_LIMITED	Free-tier daily limit reached — subscribe to Pro.
500 internal_error	Transient service error — retry with backoff.

Every error returns JSON { "error", "message" }. Branch on the stable error code.

Ready to build?

Get an API key