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"
}