# GotPlans

Austin-first local events with a public API, weekly email signup, and city-aware preferences built for humans and agents.

## Discovery
- Site: https://gotplans.ai
- Contract version: 2026-03-11.2
- Docs home: https://gotplans.ai/docs
- Human and agent docs: https://gotplans.ai/docs/agents
- API reference: https://gotplans.ai/docs/api
- API index: https://gotplans.ai/api/v1
- Cities list: https://gotplans.ai/api/v1/cities
- OpenAPI: https://gotplans.ai/openapi.json
- Robots: https://gotplans.ai/robots.txt
- Sitemap: https://gotplans.ai/sitemap.xml

## Public endpoints
- GET /api/v1
- GET /api/v1/cities
- GET /api/v1/cities/{citySlug}/events (includes occurrence time, venue, and source attribution)
- GET /api/v1/events/{eventId} (includes all occurrences and source links)
- POST /api/v1/subscribers
- POST /api/v1/submissions
- POST /api/feedback

## Rate limits
- Policy: public-read-public-write-guarded
- Docs: https://gotplans.ai/docs/rate-limits
- Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, Retry-After, X-RateLimit-Bucket

## Recommended subscriber flow
- Pattern: collect_email_and_core_preferences_together_then_confirm_with_manage_link
- Capture email plus city and optional interests in one request.
- Send a confirmation email with a signed, single-use manage-preferences URL.
- Land the user on a page where they can confirm and edit preferences without creating a password.
- Reuse later signed links for preference changes, unsubscribe, and resubscribe.

## Current market status
- Live now: Austin
- Planned intake surfaces: DFW, Houston, San Antonio, Corpus Christi