Public API
A read-only JSON API for our events and newsletter issues. It needs no account or key, answers GET only, and sends Access-Control-Allow-Origin: * so a browser app on any site can read it. Successful responses are cacheable for 60 seconds. It serves the same operations as our MCP server, and a route and its tool return the same JSON.
Base URL
https://www.opencircuitsf.com/api/public/v1/Limits
- limit defaults to 10 and is capped at 50.
- query is cut to 200 characters.
- Dates are RFC 3339 with an offset, or YYYY-MM-DD in America/Los_Angeles.
- 60 requests a minute per IP, one budget shared between /mcp and /api/public/v1/. Past that you get HTTP 429 with a Retry-After header in seconds.
- List results may be cached on the server for up to 60 seconds.
- Errors are JSON: {"error":{"code","message","fields"}}. Unknown, draft and unpublished items all return the same 404.
OpenAPI
The OpenAPI document describes every endpoint: https://www.opencircuitsf.com/api/public/v1/openapi.json.
GET /api/public/v1/events
List upcoming Open Circuit SF events, soonest first. Parameters: limit (default 10, max 50); after and before, each an RFC 3339 time or a YYYY-MM-DD date in America/Los_Angeles.
curl -s 'https://www.opencircuitsf.com/api/public/v1/events?limit=1'{
"events": [
{
"id": "esp32-intro",
"slug": "esp32-intro",
"title": "Intro to ESP32",
"summary": "Build and program your first ESP32 board.",
"starts_at": "2026-12-05T13:00:00-08:00",
"ends_at": "2026-12-05T16:00:00-08:00",
"location_name": "Noisebridge",
"address": "272 Capp St, San Francisco, CA",
"status": "scheduled",
"registration_url": "https://lu.ma/example",
"url": "https://www.opencircuitsf.com/events/esp32-intro",
"event_type": "Workshop",
"tags": [
"microcontrollers"
]
}
]
}GET /api/public/v1/events/search
Search Open Circuit SF events by words in the title, description and tags. Parameters: query (every word must match; cut to 200 characters; empty matches all); from and to (RFC 3339 or YYYY-MM-DD); include_past (default false); limit (default 10, max 50).
curl -s 'https://www.opencircuitsf.com/api/public/v1/events/search?query=esp32&limit=1'{
"events": [
{
"id": "esp32-intro",
"slug": "esp32-intro",
"title": "Intro to ESP32",
"summary": "Build and program your first ESP32 board.",
"starts_at": "2026-12-05T13:00:00-08:00",
"ends_at": "2026-12-05T16:00:00-08:00",
"location_name": "Noisebridge",
"address": "272 Capp St, San Francisco, CA",
"status": "scheduled",
"registration_url": "https://lu.ma/example",
"url": "https://www.opencircuitsf.com/events/esp32-intro",
"event_type": "Workshop",
"tags": [
"microcontrollers"
]
}
]
}GET /api/public/v1/events/{slug}
Get one Open Circuit SF event by its id (its slug), from list_upcoming_events or search_events. Adds location_note and description to the list fields. An event whose slug is search cannot be read here, because events/search takes that path; use the MCP get_event tool for it.
curl -s 'https://www.opencircuitsf.com/api/public/v1/events/esp32-intro'{
"id": "esp32-intro",
"slug": "esp32-intro",
"title": "Intro to ESP32",
"summary": "Build and program your first ESP32 board.",
"starts_at": "2026-12-05T13:00:00-08:00",
"ends_at": "2026-12-05T16:00:00-08:00",
"location_name": "Noisebridge",
"address": "272 Capp St, San Francisco, CA",
"status": "scheduled",
"registration_url": "https://lu.ma/example",
"url": "https://www.opencircuitsf.com/events/esp32-intro",
"event_type": "Workshop",
"tags": [
"microcontrollers"
],
"location_note": "Ring the buzzer.",
"description": "Bring a laptop. We supply the boards…"
}GET /api/public/v1/newsletter
List Open Circuit SF newsletter issues, newest first. Parameter: limit (default 10, max 50).
curl -s 'https://www.opencircuitsf.com/api/public/v1/newsletter?limit=1'{
"issues": [
{
"id": "november-2026",
"slug": "november-2026",
"title": "November at Open Circuit SF",
"summary": "Two workshops and a meetup.",
"published_at": "2026-11-01T09:00:00-07:00",
"url": "https://www.opencircuitsf.com/archive/november-2026"
}
]
}GET /api/public/v1/newsletter/{slug}
Get one Open Circuit SF newsletter issue by its id (its slug), from list_newsletter_issues. Adds the body as plain text.
curl -s 'https://www.opencircuitsf.com/api/public/v1/newsletter/november-2026'{
"id": "november-2026",
"slug": "november-2026",
"title": "November at Open Circuit SF",
"summary": "Two workshops and a meetup.",
"published_at": "2026-11-01T09:00:00-07:00",
"url": "https://www.opencircuitsf.com/archive/november-2026",
"body": "This month we…"
}GET /api/public/v1/about
What Open Circuit SF is, and how to join, subscribe or get in touch. No parameters.
curl -s 'https://www.opencircuitsf.com/api/public/v1/about'{
"name": "Open Circuit SF",
"description": "Open Circuit SF is a community…",
"sections": [
{
"heading": "What we do",
"text": "Hands-on electronics workshops…"
}
],
"website_url": "https://www.opencircuitsf.com/",
"events_url": "https://www.opencircuitsf.com/events",
"newsletter_archive_url": "https://www.opencircuitsf.com/archive",
"subscribe_url": "https://www.opencircuitsf.com/subscribe",
"contact_email": "contact@opencircuitsf.com",
"discord_url": "https://discord.gg/example",
"calendar_url": "https://lu.ma/example"
}