Docs

Public API docs for humans and agents.

The OpenAPI document is the contract, Scalar is the interactive reference, and these pages explain how to use the Austin-first API without guessing.

API referenceOpenAPI JSONAPI index

Rate limits

Public reads are open. Public writes are guarded.

Read policy

public-read

  • 120 requests / minute / IP
  • 3,000 requests / day / IP

Applied to: /api/v1, /api/v1/cities, /api/v1/cities/{citySlug}/events, /api/v1/events/{eventId}, /openapi.json

Write policy

  • /api/v1/subscribers: 10 requests / 10 minutes / IP; 5 requests / hour / email; 20 requests / day / email
  • /api/v1/submissions: 5 requests / hour / IP; 20 requests / day / IP
  • /api/feedback: 10 requests / hour / IP; 30 requests / day / IP

Headers

  • X-RateLimit-Limit
  • X-RateLimit-Remaining
  • X-RateLimit-Reset
  • Retry-After
  • X-RateLimit-Bucket

429 body

{
  "ok": false,
  "error": "Rate limit exceeded.",
  "code": "rate_limited",
  "bucket": "public-read",
  "retryAfterSeconds": 60
}