DC Member API — Developer Documentation v1.11.1

Programmatic access to your Dynamite Circle membership data — trips, events, profile, tickets, and more. For active DC members only. Designed for AI assistants, automation, and personal integrations.

For ALL active non-trial DC members. Every active DC member is eligible once their trial period ends — DC and DC BLACK alike, no further gating.

Open the user menu inside the DC member area and choose DC Member API Key to generate one.

Who can use this API?

The DC Member API is open to every active non-trial Dynamite Circle member — DC and DC BLACK alike, with no membership-age requirement once you're past trial. It exposes the same data you can already see in the DC app — your trips, events, tickets, profile, inbox, and rooms — programmatically, so you can build personal automations or hand it to an AI assistant on your behalf.

If you're not a member yet, you can learn more about Dynamite Circle or apply to join. DC is a private community for established location-independent founders.

Authentication

All requests require an API key. Active members will see the DC Member API Key option in their profile dropdown on dc.dynamitecircle.com once eligible (currently rolling out to admins and testers first; broader access coming soon). Send the key as a Bearer token:

Authorization: Bearer dk_your_api_key

Base URL: https://api.dynamitecircle.com

Keys are issued to all active non-trial DC members (DC or DC BLACK). Trial accounts, guests, and inactive accounts return 403.

Official client — Agent Skill, CLI, Python library, MCP server

The fastest way to use the API — and to plug it into Claude Code, Codex CLI, Gemini CLI, Cursor, GitHub Copilot, or Claude Desktop — is the official DC client. Published on PyPI as dynamitecircle; source at github.com/dynamitecircle/dc. One self-contained Python file, stdlib only, that ships as four integrations from the same source: Agent Skill (auto-discovered via SKILL.md), CLI (dc …), Python library (from dc import DC), and MCP server (dc --mcp, optional mcp dep).

Install via PyPI (easiest)

pip install dynamitecircle
dc setup --api-key dk_your_api_key
dc self-test
dc profile

Same code as the repo, version-locked to the deployed API. View on PyPI →

Or clone the public repo

Useful if you want the MCP server config (.mcp.json at the repo root auto-registers every endpoint as an mcp__dc__* tool when you open the dir in Claude Code), or want to vendor the file via git submodule / subtree:

git clone https://github.com/dynamitecircle/dc.git
cd dc
python3 py/dc.py setup --api-key dk_your_api_key
python3 py/dc.py profile

Python library

from dc import DC

dc = DC()
dc.profile()
dc.trips(past=True, limit=10)
dc.event_rsvp("<eventID>", "yes")
dc.locator(sections="homeCity,favoriteCities")

MCP server (Claude Desktop, Cursor, Codex MCP, Cline, etc.)

The same file runs as an MCP server so MCP-compatible clients call every endpoint as a tool:

pip install dynamitecircle[mcp]
dc --mcp

Codex CLI and Gemini CLI auto-discover the skill via AGENTS.md / GEMINI.md (both symlinked to CLAUDE.md in the repo). See the repo README for per-tool setup (Claude Desktop, Codex CLI, Gemini CLI, Cursor) and update strategies (pip install --upgrade, git clone, submodule, subtree, symlink).

Rate limits

TierPer minutePer day
DC member10300
DC BLACK member603,000

Rate limit headers on every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-RateLimit-Daily-Remaining.

Response format

// Success
{ "ok": true, "data": { ... } }

// Error
{ "ok": false, "error": "error_code", "message": "Human-readable message" }

Endpoints

Announcements

GET /announcements — List recent announcements

Returns the most recent announcements from DC's broadcast channels — official updates from the DC team and chapter staff (DC, DCBKK, DCMEX, DC BLACK, etc.). Same content you see in the app's announcements channels, in a flat newest-first feed. Visibility mirrors the app: DC members see DC-scope announcements; DC BLACK members and staff additionally see DC BLACK announcements. There is no posting, replying, or per-channel filtering — announcements are intentionally one-way and minimal.

Query parameters

  • limit number default: 10

    Max announcements to return (1-50)

  • cursor string

    Opaque cursor from a previous response's `nextCursor`

Response

  • announcements object[]

    Newest-first list of announcements visible to the caller

    • createdAt string

      When the announcement was posted (ISO 8601)

    • content string

      Markdown content of the announcement

    • announcementURL string

      Deep-link back to the announcement in the DC app

    • author object

      Author of the announcement (DC team member or chapter lead)

      • userID string

        Author user ID

      • userName string

        Username (used in profile URL)

      • displayName string

        Display name

      • photo string

        Profile photo URL

      • profileURL string

        Link to the author's profile on DC

  • nextCursor string

    Cursor for the next (older) page, or null when there are no more

Example: Latest announcements (default 10)

{
  "data": {
    "announcements": [
      {
        "announcementURL": "https://dc.dynamitecircle.com/room/abc/channel?m=xyz",
        "author": {
          "displayName": "Dan Andrews",
          "photo": "https://...",
          "profileURL": "https://dc.dynamitecircle.com/profile/DanAndrews",
          "userID": "1",
          "userName": "DanAndrews"
        },
        "content": "DCBKK 2026 early-bird tickets are live until Friday — see you in Bangkok!",
        "createdAt": "2026-04-30T10:00:00.000Z"
      }
    ],
    "nextCursor": "MTcxNzIwMDAwMDAwMA"
  },
  "ok": true
}

GET /announcements/latest — Latest announcement per channel (quick overview)

Returns the **single most recent announcement from each visible channel** — a one-shot overview rather than a paged feed. Useful as a "what's new across DC?" quick check before drilling into the full feed via `GET /announcements`. Visibility rules are identical to `/announcements`: DC members see DC-scope channels; DC BLACK members and staff additionally see DC BLACK channels. No pagination — the result size equals the number of dispatch channels you can see (currently ~4).

Response

  • announcements object[]

    One most-recent announcement from each visible dispatch channel. Same per-item shape as `GET /announcements`.

Example: Latest announcement per channel

{
  "data": {
    "announcements": [
      {
        "announcementURL": "https://dc.dynamitecircle.com/room/abc/channel?m=xyz",
        "author": {
          "displayName": "Dan Andrews",
          "photo": "https://...",
          "profileURL": "https://dc.dynamitecircle.com/profile/DanAndrews",
          "userID": "1",
          "userName": "DanAndrews"
        },
        "content": "DCBKK 2026 early-bird tickets are live until Friday — see you in Bangkok!",
        "createdAt": "2026-04-30T10:00:00.000Z"
      }
    ]
  },
  "ok": true
}

Profile

GET /profile — Get your own profile

Returns your full profile including all fields visible to you. DC BLACK members see additional business fields.

Response

  • userID string

    Your unique member ID.

  • userName string

    Your DC username — appears in your profile URL.

  • displayName string

    Your display name shown across the DC app.

  • photo string

    Profile photo URL.

  • profileURL string

    Link to your public profile on DC.

  • headline string

    One-sentence elevator pitch shown at the top of your profile.

  • industry string

    Primary business industry (predefined bracket).

    Values: SaaS & Tech, Marketing Agency, Productized Services, Ecommerce & Amazon, Courses and Info Products, Affiliate, Content Creation, or Ad Revenue, Professional Services & Industry Specific Consulting, Real Estate and Investing, Coaching, Other

  • joinedDate string

    Date you joined DC (YYYY-MM-DD).

  • tier string

    Your membership tier.

    Values: dcc, dcb

  • bizName string

    Name of your primary business.

  • bizDesc string

    Description of your primary business (plain text or HTML).

  • bizRevenue string

    Annual revenue bracket of your primary business.

    Values: No real income yet, it's still getting off the ground., I recently exited a business., $10K+, $50K+, $100K+, $250K+, $300K+, $600K+, $1M+, $2M+, $3M+, $4M+, $7M+, $10M+, $20M+, $35M+, $60M+, $100M+, Prefer not to say

  • bizRevenueIsPrivate boolean

    Visibility of your revenue. `true` = hidden from other DCers (only DC staff can see it); `false` = visible to all DCers.

  • bizTeam string

    Team size bracket of your primary business.

    Values: None, 1-2, 3-5, 6-9, 10-14, 15-19, 20-34, 35-49, 50-74, 75-99, 100+, Prefer not to say

  • bizTeamIsPrivate boolean

    Visibility of your team size. `true` = hidden from other DCers (only DC staff can see it); `false` = visible to all DCers.

  • bizWeb string

    Public website for your primary business.

  • yearsInBiz string

    How long you have been on the entrepreneurial path.

    Values: Less than one year, 1-2 years, 3-6 years, 7-9 years, 10-15 years, 15-20 years, More than 20 years

  • connectIsPrivate boolean

    Visibility of your "who I want to meet" answer. `true` = hidden from other DCers (only DC staff can see it); `false` = visible to all DCers.

  • linkedin string

    LinkedIn handle.

  • twitter string

    Twitter/X handle.

  • github string

    GitHub handle. Required for access to the public DC client repo.

Example: Get your profile

{
  "data": {
    "bizName": "Acme Inc",
    "bizWeb": "https://example.com",
    "displayName": "Jane Doe",
    "headline": "Founder at Acme Inc",
    "industry": "SaaS & Tech",
    "joinedDate": "2020-01-15",
    "photo": "https://storage.googleapis.com/dc-nav.appspot.com/...",
    "profileURL": "https://dc.dynamitecircle.com/profile/JaneDoe",
    "tier": "dcb",
    "userID": "1234",
    "userName": "JaneDoe"
  },
  "ok": true
}

PATCH /profile — Update profile fields

Update allowed profile fields. Only the fields you include will be changed. Location, photo, and gender cannot be updated via API.

Request body

  • headline string

    One-sentence elevator pitch shown at the top of your DC profile (max 64 chars).

  • bizName string

    Name of the main business you run or are primarily focused on right now (max 256 chars). You can list other businesses in `bizOther`.

  • bizDesc string

    Description of your primary business. Plain text or HTML, up to 1600 chars.

  • bizWeb string

    Public website for your primary business — single URL only (max 256 chars).

  • bizIndustry string

    Category your primary business fits into. Must be one of the predefined industries.

    Values: SaaS & Tech, Marketing Agency, Productized Services, Ecommerce & Amazon, Courses and Info Products, Affiliate, Content Creation, or Ad Revenue, Professional Services & Industry Specific Consulting, Real Estate and Investing, Coaching, Other

  • bizRevenue string

    Approximate annual revenue (in U.S. dollars) of your primary business over the last 12 months. Predefined bracket.

    Values: No real income yet, it's still getting off the ground., I recently exited a business., $10K+, $50K+, $100K+, $250K+, $300K+, $600K+, $1M+, $2M+, $3M+, $4M+, $7M+, $10M+, $20M+, $35M+, $60M+, $100M+, Prefer not to say

  • bizRevenueIsPrivate boolean

    Visibility of your revenue. `true` = hidden from other DCers (only DC staff can see it); `false` = visible to all DCers.

  • bizTeam string

    Number of full-time and part-time team members in your primary business. Predefined bracket.

    Values: None, 1-2, 3-5, 6-9, 10-14, 15-19, 20-34, 35-49, 50-74, 75-99, 100+, Prefer not to say

  • bizTeamIsPrivate boolean

    Visibility of your team size. `true` = hidden from other DCers (only DC staff can see it); `false` = visible to all DCers.

  • yearsInBiz string

    How long you have been on the entrepreneurial path. Used for matching with other members. Predefined bracket.

    Values: Less than one year, 1-2 years, 3-6 years, 7-9 years, 10-15 years, 15-20 years, More than 20 years

  • bizOther string

    Other businesses you currently operate. Feel free to share URL, short description, and year started for each (up to 1600 chars).

  • bizPast string

    Previous business exits and entrepreneurial experience worth listing (up to 1600 chars).

  • linkedin string

    LinkedIn username only (no URL prefix). 1-50 chars: letters, digits, `.`, `_`, `-`.

  • twitter string

    Twitter/X username only (no URL prefix). 1-15 chars: letters, digits, `_`.

  • instagram string

    Instagram username only (no URL prefix). 1-30 chars: letters, digits, `.`, `_`.

  • facebook string

    Facebook username only (no URL prefix). 5-50 chars: letters, digits, `.`.

  • focusmate string

    Focusmate username only (no URL prefix). 3-50 chars: letters, digits, `_`, `-`.

  • github string

    GitHub username only (no URL prefix). 1-39 chars per GitHub's rules: letters, digits, `-`. Required to be granted access to the public DC client repo — set this to opt in.

  • whatsapp string

    WhatsApp phone number in international format — `+` followed by 5-16 digits, no dashes or spaces. Required if you want to be added to the DC WhatsApp community. Always private — only visible to DC staff.

  • expertise string

    Areas you might consider yourself an expert in — skills you can use to help other members (up to 1600 chars).

  • ama string

    Topics other members can ask you about, in your field of expertise (up to 1600 chars).

  • hobbies string

    Your non-business hobbies — games, camping, art, sports, anything (up to 1600 chars).

  • goal string

    Your current business challenge or goal. Used internally to match you with other members who can help (up to 1600 chars).

  • connect string

    What kinds of community members you would like to connect with. Used to send recommendations of relevant DCers (up to 1600 chars). Set `connectIsPrivate: true` to keep this visible only to DC staff.

  • connectIsPrivate boolean

    Visibility of your "who I want to meet" answer. `true` = hidden from other DCers (only DC staff can see it); `false` = visible to all DCers.

  • locs string

    Cities or regions you frequently visit. Helps surface trip overlaps with other members (up to 1600 chars).

  • nickname string

    Display name override — what other DCers see in addition to your real name (max 256 chars).

  • spouseName string

    Name of your spouse or partner — used only for the DCBKK partner pass. Always private (DC staff only).

  • shirtSize string

    T-shirt size — used when DC sends event swag.

    Values: XS, S, M, L, XL, XXL, XXXL

  • diet string

    Dietary restrictions — used when DC plans event meals.

    Values: No Restrictions, Vegan, Vegetarian, Gluten-Free, Dairy/Lactose-Free

Response

  • updated string[]

    List of field names that were updated

Example: Update headline and LinkedIn

{
  "headline": "Building SaaS for nomads",
  "linkedin": "janedoe"
}
{
  "data": {
    "updated": [
      "headline",
      "linkedin"
    ]
  },
  "ok": true
}

Trips

GET /trips — List your trips

Returns your upcoming trips by default. Add `?past=true` to include past trips.

Query parameters

  • past boolean default: false

    Include past trips

  • limit number default: 50

    Max results (1-100)

Response

  • trips ApiTrip[]

    Array of trips

    • tripID string

      Trip ID

    • note string

      Trip note/description

    • location object

      Trip destination (city-level)

      • placeID string

        Google Place ID

      • name string

        Place name

      • city string

        City

      • country string

        Country

      • countryCode string

        ISO country code

      • region string

        Region / state / prefecture

      • regionCode string

        Region short code

      • description string

        Friendly display string

      • lat number

        Latitude

      • lon number

        Longitude

      • latLon string

        "lat,lon" string

      • locHash string

        Geohash for the location

      • utcOffsetMins number

        UTC offset in minutes

    • startDate string

      Start date (ISO 8601)

    • endDate string

      End date (ISO 8601)

Example: List upcoming trips

{
  "data": {
    "trips": [
      {
        "endDate": "2026-04-17T00:00:00.000Z",
        "location": {
          "city": "Bangkok",
          "country": "Thailand",
          "countryCode": "TH",
          "description": "Bangkok, Thailand",
          "lat": 13.7563309,
          "latLon": "13.7563309,100.5017651",
          "lon": 100.5017651,
          "name": "Bangkok",
          "placeID": "ChIJ82ENKDJgHTERIEjiXbIAAQE",
          "region": "Bangkok",
          "regionCode": "10",
          "utcOffsetMins": 420
        },
        "note": "DCBKK week",
        "startDate": "2026-04-10T00:00:00.000Z",
        "tripID": "abc123"
      }
    ]
  },
  "ok": true
}

POST /trips — Create a trip

Create a new trip. Provide exactly one of `placeID` or `eventID` — the server resolves the location (city, country, country code) automatically. Use `GET /places/search` to find a placeID by city/country name first, or pass an `eventID` from `/events` to create a trip to that event's city.

Request body

  • startDate string required

    Start date (ISO 8601)

  • endDate string required

    End date (ISO 8601)

  • placeID string

    Google Place ID for the destination. Look one up via `GET /places/search`. Required if `eventID` is not provided.

  • eventID string

    DC event ID. Server uses the event's city placeID. Required if `placeID` is not provided.

  • note string

    Trip note

Response

  • trip ApiTrip

    The created trip

Example: Create a trip to Lisbon by placeID

{
  "endDate": "2026-05-10",
  "note": "Co-working week",
  "placeID": "ChIJ-ZRLfIQzMBQR2bAQQ8sZh90",
  "startDate": "2026-05-01"
}
{
  "data": {
    "trip": {
      "endDate": "2026-05-10T00:00:00.000Z",
      "eventID": null,
      "location": {
        "city": "Lisbon",
        "country": "Portugal",
        "countryCode": "PT",
        "description": "Lisbon, Portugal",
        "lat": 38.7222524,
        "latLon": "38.7222524,-9.1393366",
        "lon": -9.1393366,
        "name": "Lisbon",
        "placeID": "ChIJ-ZRLfIQzMBQR2bAQQ8sZh90",
        "region": "Lisbon",
        "regionCode": "11",
        "utcOffsetMins": 60
      },
      "note": "Co-working week",
      "startDate": "2026-05-01T00:00:00.000Z",
      "tripID": "new123"
    }
  },
  "ok": true
}

Example: Create a trip linked to an event

{
  "endDate": "2026-05-22",
  "eventID": "sWnllj1DW2jLMZ1n2KWB",
  "note": "Attending DCBKK",
  "startDate": "2026-05-18"
}
{
  "data": {
    "trip": {
      "endDate": "2026-05-22T00:00:00.000Z",
      "eventID": "sWnllj1DW2jLMZ1n2KWB",
      "location": {
        "city": "Bangkok",
        "country": "Thailand",
        "countryCode": "TH",
        "description": "Bangkok, Thailand",
        "lat": 13.7563309,
        "latLon": "13.7563309,100.5017651",
        "lon": 100.5017651,
        "name": "Bangkok",
        "placeID": "ChIJ82ENKDJgHTERIEjiXbIAAQE",
        "region": "Bangkok",
        "regionCode": "10",
        "utcOffsetMins": 420
      },
      "note": "Attending DCBKK",
      "startDate": "2026-05-18T00:00:00.000Z",
      "tripID": "new456"
    }
  },
  "ok": true
}

PATCH /trips/:tripID — Update a trip

Update one or more fields on an existing trip. Only include the fields you want to change. To change destination, provide either `placeID` or `eventID` and the full location will be re-resolved.

Path parameters

  • tripID e.g. abc123

    The trip ID to update

Request body

  • startDate string

    New start date (ISO 8601)

  • endDate string

    New end date (ISO 8601)

  • placeID string

    New destination — Google Place ID

  • eventID string

    New destination — DC event ID (uses event's city). Pass `null` to unlink without changing the location.

  • note string

    Updated note

Response

  • trip ApiTrip

    The updated trip

DELETE /trips/:tripID — Delete a trip

Path parameters

  • tripID e.g. abc123

    The trip ID to delete

Response

  • deleted boolean

    Whether the trip was deleted

GET /trips/overlaps — Find overlapping trips

Find other members whose trips overlap with yours in the same city and date range. Only shows trips that the owner has chosen to share with all DCers — staff-only trips are excluded.

Query parameters

  • limit number default: 10

    Max trips to check (1-20)

Response

  • overlaps object[]

    One entry per upcoming trip of yours that has overlapping trips from other DCers

    • trip object

      Your trip

      • tripID string

        Trip ID

      • eventID string

        Linked event ID (null if not linked)

      • note string

        Trip note

      • startDate string

        Start date (ISO 8601)

      • endDate string

        End date (ISO 8601)

      • location object

        Trip destination

        • placeID string

          Google Place ID

        • name string

          Display name

        • city string

          City

        • country string

          Country

        • countryCode string

          ISO country code

    • matches object[]

      Other members whose trips overlap with yours in this destination

      • member object

        The other member's profile (same shape as `/profile` for other DCers)

        • userID string

          Member ID

        • userName string

          Username (handle)

        • displayName string

          Display name

        • photo string

          Profile photo URL

        • profileURL string

          Profile URL on DC

        • headline string

          Profile headline

        • industry string

          Business industry

        • joinedDate string

          Join date (YYYY-MM-DD)

      • trip object

        Their overlapping trip

        • tripID string

          Their trip ID

        • note string

          Their trip note (if shared)

        • startDate string

          Their start date (ISO 8601)

        • endDate string

          Their end date (ISO 8601)

      • overlapDays number

        Number of overlapping days between your trip and theirs

Example: Find who else is in Bangkok during your trip

{
  "data": {
    "overlaps": [
      {
        "matches": [
          {
            "member": {
              "displayName": "Jane Doe",
              "profileURL": "https://dc.dynamitecircle.com/profile/JaneDoe",
              "userID": "123"
            },
            "overlapDays": 5,
            "trip": {
              "endDate": "2026-04-20T00:00:00.000Z",
              "startDate": "2026-04-12T00:00:00.000Z",
              "tripID": "theirtrip1"
            }
          }
        ],
        "trip": {
          "endDate": "2026-04-17T00:00:00.000Z",
          "location": {
            "city": "Bangkok"
          },
          "startDate": "2026-04-10T00:00:00.000Z",
          "tripID": "mytrip1"
        }
      }
    ]
  },
  "ok": true
}

Events

GET /events — List upcoming events

Returns upcoming DC events. Add `?past=true` to include past events.

Query parameters

  • past boolean default: false

    Include past events

  • limit number default: 20

    Max results (1-50)

Response

  • events object[]

    Array of events

    • eventID string

      Event ID

    • name string

      Event name

    • slug string

      URL slug

    • eventURL string

      Link to event on DC

    • description string

      Full description (markdown)

    • descriptionShort string

      Short description (markdown)

    • eventType string

      Event type (dcbkk, junto, meet-up, etc.)

    • headerImage string

      Header image URL

    • city object

      Event city

      • name string

        City name

      • country string

        Country

      • countryCode string

        ISO country code

      • placeID string

        Google Place ID for the city — pass to POST /trips to create a trip to this event

    • venue object

      Event venue (the specific building/place inside the event city). `null` until a venue is announced (TBA events).

      • name string

        Venue name (e.g. "Hilton Mexico City Reforma")

      • placeID string

        Google Place ID for the venue — pass to Google Maps for directions, or to `GET /places/:placeID` for full details

      • city string

        City the venue is in (usually matches `event.city.name`, but may differ for satellite venues)

      • country string

        Country

      • countryCode string

        ISO country code

      • region string

        State / region / administrative area

      • lat number

        Latitude (decimal degrees)

      • lon number

        Longitude (decimal degrees)

    • venueInfo string

      Free-text note about the venue (e.g. "2nd floor, ask for DC group"). Separate from the structured `venue` object above.

    • startDate string

      Start date (ISO 8601)

    • endDate string

      End date (ISO 8601)

    • ticketsEnabled boolean

      Whether tickets are available

    • rsvpEnabled boolean

      Whether RSVP is available

GET /events/:eventID — Get event details

Returns full details for a specific event, including your ticket status.

Path parameters

  • eventID e.g. sWnllj1DW2jLMZ1n2KWB

    The event ID

Response

  • event object

    Full event details

  • myTickets object[]

    Your tickets for this event (empty array if none)

GET /events/:eventID/attendees — List event attendees

Returns the list of attendees for an event. Includes members with valid paid tickets or active RSVP status.

Path parameters

  • eventID e.g. sWnllj1DW2jLMZ1n2KWB

    The event ID

Query parameters

  • limit number default: 100

    Max results (1-200)

Response

  • attendees object[]

    Array of attendee base profiles

    • userID string

      Member ID

    • userName string

      Username (handle)

    • displayName string

      Display name

    • photo string

      Profile photo URL

    • profileURL string

      Profile URL on DC

    • headline string

      Profile headline

    • industry string

      Business industry

    • joinedDate string

      Join date (YYYY-MM-DD)

  • total number

    Total attendee count

POST /events/:eventID/rsvp — RSVP to a free event

RSVP to an event that uses free RSVP (not ticketed). Only works for events with rsvpEnabled: true.

Path parameters

  • eventID e.g. sWnllj1DW2jLMZ1n2KWB

    The event ID

Request body

  • status string required

    RSVP status

    Values: yes, maybe, no

Response

  • rsvp object

    Your RSVP record

GET /events/:eventID/schedule — Get event schedule

Returns the full schedule (sessions) for an event, sorted chronologically. **Time-zone handling:** session `startAt` / `endAt` are returned as ISO 8601 strings whose digits represent the **venue-local wall-clock time** (e.g. a 9 AM Mexico City session returns `2026-05-08T09:00:00.000Z`, NOT `15:00:00Z`). The session's `timezone` field carries the IANA zone (e.g. `America/Mexico_City`) — pair them when localizing. This matches the convention used by the DC ICS feed; see `cal.ts` for the rationale.

Path parameters

  • eventID e.g. BbZlk82DNQFbV4HT2nJo

    Event ID

Response

  • sessions object[]

    Sessions in chronological order. `date` is YYYY-MM-DD (venue-local) for day-grouping; `startAt`/`endAt` are wall-clock ISO strings + `timezone` for full localization.

    • sessionID string

      Session ID

    • title string

      Title

    • description string

      Description (markdown)

    • date string

      Date YYYY-MM-DD (venue-local — used to group sessions by day)

    • startAt string

      Start time as wall-clock ISO 8601 (digits are venue-local; pair with `timezone`)

    • endAt string

      End time as wall-clock ISO 8601 (digits are venue-local; pair with `timezone`)

    • timezone string

      IANA timezone of the venue (e.g. America/Mexico_City)

    • type string

      Session type

      Values: mainstage, talk, workshop, discussion, meetup, mastermind, social, morning, break, other

    • speakers object[]

      Speakers — array of `{ userID, name, photoURL, bio }`

    • themes string[]

      Topic tags

    • audience string

      One-line "who is this for"

    • capacity number

      Capacity override (null = use venue default)

    • rsvpCount number

      Number of attendees who bookmarked this session

    • venueID string

      Venue ID at the event (or null for off-site sessions)

    • place object

      Off-site place (when locationType=place)

    • locationNote string

      Free-text location label (when locationType=note)

    • locationType string

      Location source

      Values: venue, place, note

    • spansAllVenues boolean

      True if the session spans every venue (general assembly, etc.)

  • timezone string

    IANA timezone of the event venue

GET /events/:eventID/agenda — Get your personal agenda for an event

Returns the sessions and meetups **YOU** have on your personal agenda for an event: - Sessions you bookmarked from the schedule (from `cal/{eventID}/agenda/{userID}.sessionIDs`) - Meetups you RSVPd to (from `cal/{eventID}/meetups` where `rsvpIDs array-contains userID`) Use `POST /events/:eventID/schedule/:sessionID/bookmark` and `POST /events/:eventID/meetups/:meetupID/rsvp` to manage entries.

Path parameters

  • eventID e.g. BbZlk82DNQFbV4HT2nJo

    Event ID

Response

  • sessions object[]

    Sessions you have bookmarked, in chronological order. Same per-item shape as `/schedule`.

  • meetups object[]

    Meetups you have RSVPd to, in chronological order. Same per-item shape as `/meetups`.

  • timezone string

    IANA timezone of the event venue

GET /events/:eventID/agenda/:userID — Get another attendee's agenda for an event

Returns another attendee's personal agenda for an event — the sessions they bookmarked + meetups they RSVPd to. Use this so an AI agent can plan together with another DCer (find a coffee window, suggest sessions to overlap, propose a meetup). **Auth**: ticket-holder ↔ ticket-holder. Both you and the target must hold a valid ticket to the event. **Privacy**: no separate gate — agenda data is already public via `/events/:eventID/schedule/:sessionID/attendees` (which lists every member who bookmarked a session). This endpoint just rotates the same data per-person.

Path parameters

  • eventID e.g. BbZlk82DNQFbV4HT2nJo

    Event ID

  • userID e.g. 1673

    Target attendee userID

Response

  • profile object

    Mini profile of the target attendee

    • userID string

      Member ID

    • userName string

      Username (handle)

    • displayName string

      Display name

    • photo string

      Profile photo URL

    • profileURL string

      Profile URL on DC

    • headline string

      Profile headline

  • sessions object[]

    Sessions they have bookmarked, chronological order

  • meetups object[]

    Meetups they have RSVPd to, chronological order

  • timezone string

    IANA timezone of the event venue

GET /events/:eventID/schedule/:sessionID/attendees — List session attendees (people who bookmarked it)

Returns the list of attendees who have **bookmarked** a specific session into their agenda. Same minimal profile shape as `/events/:eventID/attendees`.

Path parameters

  • eventID e.g. BbZlk82DNQFbV4HT2nJo

    Event ID

  • sessionID e.g. session_abc123

    Session ID

Response

  • attendees object[]

    Attendees who have this session in their agenda

  • total number

    Total attendee count for this session

GET /events/:eventID/meetups — List event meetups

Returns the approved member-organized meetups for an event, sorted chronologically. Only approved meetups are returned. **Time-zone handling:** meetups use explicit wall-clock fields (`date` = YYYY-MM-DD, `startTime` / `endTime` = HH:mm) plus the event's `timezone` (IANA). Pair them when localizing.

Path parameters

  • eventID e.g. BbZlk82DNQFbV4HT2nJo

    Event ID

Response

  • meetups object[]

    Approved meetups in chronological order

    • meetupID string

      Meetup ID

    • title string

      Title

    • shortDescription string

      Short description (one-line)

    • description string

      Long description (markdown)

    • date string

      Date YYYY-MM-DD (venue-local)

    • startTime string

      Start time HH:mm (venue-local)

    • endTime string

      End time HH:mm (venue-local)

    • timezone string

      IANA timezone of the event

    • maxSeats number

      Maximum attendees

    • rsvpCount number

      Current RSVP count

    • host object

      Host (the member organizing the meetup)

    • venue object

      Meeting venue (Place — name, city, country, placeID)

    • venueDetails string

      Free-text venue details (e.g. "ask for DC group")

  • timezone string

    IANA timezone of the event venue

GET /events/:eventID/meetups/:meetupID/attendees — List meetup attendees

Returns the list of attendees who have RSVPd to a specific meetup. Same minimal profile shape as `/events/:eventID/attendees`.

Path parameters

  • eventID e.g. BbZlk82DNQFbV4HT2nJo

    Event ID

  • meetupID e.g. meetup_xyz789

    Meetup ID

Response

  • attendees object[]

    Attendees who RSVPd to this meetup

  • total number

    Total RSVP count

GET /events/:eventID/sponsors — List event sponsors

Returns the sponsors for an event, ordered by tier (primary → supporting) then internal display order. Deleted sponsors are filtered out.

Path parameters

  • eventID e.g. BbZlk82DNQFbV4HT2nJo

    Event ID

Response

  • sponsors object[]

    Sponsors in display order (tier first, then `order` within tier)

    • sponsorID string

      Sponsor ID

    • name string

      Sponsor name

    • logoURL string

      Logo image URL

    • websiteURL string

      Marketing website URL

    • description string

      Description (markdown)

    • tier string

      Sponsorship tier

      Values: primary, supporting

POST /events/:eventID/schedule/:sessionID/bookmark — Bookmark / unbookmark a session

Add or remove a session from your personal agenda — this is the API equivalent of the bookmark/star icon on a session card in the DC app. Requires a valid ticket for the event. Counter `rsvpCount` on the session doc is updated atomically.

Path parameters

  • eventID e.g. BbZlk82DNQFbV4HT2nJo

    Event ID

  • sessionID e.g. session_abc123

    Session ID

Request body

  • bookmarked boolean required

    `true` to add to agenda, `false` to remove

Response

  • bookmarked boolean

    Final bookmark state on your agenda

POST /events/:eventID/meetups/:meetupID/rsvp — RSVP to / leave a meetup

Join or leave a meetup. Requires a valid ticket for the event. The meetup's `rsvpCount` is updated atomically. Note: in the DC app, joining a meetup also subscribes you to the meetup's chat channel. The API write does NOT subscribe to chat — open the meetup in the app once if you want chat updates.

Path parameters

  • eventID e.g. BbZlk82DNQFbV4HT2nJo

    Event ID

  • meetupID e.g. meetup_xyz789

    Meetup ID

Request body

  • joined boolean required

    `true` to join, `false` to leave

Response

  • joined boolean

    Final RSVP state

  • rsvpCount number

    Current RSVP count for this meetup (after your change)

Virtual Events

GET /virtual-events — List virtual events

Returns upcoming virtual events (online sessions like Connect Calls, Happy Hour, Welcome Call, plus DC BLACK-only events). Add `?past=true` to include past events.

Query parameters

  • past boolean default: false

    Include past events

  • limit number default: 20

    Max results (1-50)

Response

  • events object[]

    Array of virtual events

    • sessionID string

      Session ID

    • name string

      Event name

    • kind string

      Session kind

      Values: dc, dcb, dca, welcome, happy, virtual

    • description string

      Event description

    • scheduledAt string

      Scheduled start (ISO 8601)

    • scheduledEndAt string

      Scheduled end (ISO 8601)

    • duration number

      Duration in minutes

    • attendeeCount number

      Number of attendees

    • isLive boolean

      Whether the event is currently live

    • myRsvp string

      Your RSVP (null if none)

      Values: yes, no, maybe

    • meetUrl string

      Meet/video URL (if you RSVPd yes/maybe)

GET /virtual-events/:sessionID — Get virtual event details

Returns full details for a single virtual event.

Path parameters

  • sessionID e.g. abc123

    The session ID

Response

  • event object

    Virtual event details

POST /virtual-events/:sessionID/rsvp — RSVP to virtual event

RSVP to a virtual event.

Path parameters

  • sessionID e.g. abc123

    The session ID

Request body

  • status string required

    RSVP status

    Values: yes, maybe, no

Response

  • rsvp object

    Updated RSVP status

Tickets

GET /tickets — List your tickets

Returns all your tickets across events, newest first. Filter by status with `?status=valid`.

Query parameters

  • status string

    Filter by ticket status

  • limit number default: 50

    Max results (1-100)

Response

  • tickets object[]

    Array of tickets

    • ticketID string

      Ticket ID

    • eventID string

      Event ID

    • eventName string

      Event name

    • eventType string

      Event type

    • eventURL string

      Link to event on DC

    • status string

      Ticket status

      Values: valid, maybe, refunded, canceled

    • ticketName string

      Ticket name (e.g. "General Admission")

    • ticketSlug string

      Ticket slug

    • startDate string

      Event start date (ISO 8601)

    • endDate string

      Event end date (ISO 8601)

    • paidAt string

      Purchase date (ISO 8601)

Example: List your valid tickets

{
  "data": {
    "tickets": [
      {
        "endDate": "2026-04-17T00:00:00.000Z",
        "eventID": "evt456",
        "eventName": "DCBKK 2026",
        "eventType": "dcbkk",
        "paidAt": "2026-02-15T10:30:00.000Z",
        "startDate": "2026-04-10T00:00:00.000Z",
        "status": "valid",
        "ticketID": "tkt789",
        "ticketName": "General Admission",
        "ticketSlug": "general-admission"
      }
    ]
  },
  "ok": true
}

Invites

GET /invites — List your invites

Returns all invites/referrals you have sent.

Query parameters

  • limit number default: 50

    Max results (1-100)

Response

  • invites object[]

    Array of invite records

    • inviteID string

      Invite ID

    • status string

      Invite status

      Values: new, invited, started, submitted, approved, rejected, expired

    • type string

      Invite type

      Values: manual, permaCode, mention

    • fullName string

      Invitee full name

    • email string

      Invitee email

    • permaCode string

      Permanent invite code (for permaCode invites)

    • createdAt string

      Created date (ISO 8601)

    • expiresAt string

      Expiration date (ISO 8601)

POST /invites — Send an invite

Send a referral invite to someone. They will receive an email with instructions to apply.

Request body

  • fullName string required

    Invitee full name

  • email string required

    Invitee email address

  • whyDC string

    Why they would be a good fit for DC

Response

  • invite object

    The created invite record

GET /invites/permacode — Get your permacode

Returns your permanent referral code. Share this link to let people apply with your referral.

Response

  • permaCode string

    Your permanent referral code

  • referralURL string

    Full referral URL

Inbox

GET /inbox/unread — Get unread counts

Returns your total unread message count and per-room breakdown. Only includes rooms you are subscribed to or are a member of.

Query parameters

  • limit number default: 50

    Max rooms to return (1-200)

Response

  • totalUnread number

    Total unread messages across all rooms

  • rooms object[]

    Per-room unread counts

    • roomID string

      Room ID

    • roomName string

      Room name

    • roomType string

      Room type (channel, direct, group, etc.)

    • roomURL string

      Permalink to the room

    • badgeCount number

      Unread message count for this room

Example: Check unread messages

{
  "data": {
    "rooms": [
      {
        "badgeCount": 5,
        "roomID": "room1",
        "roomName": "General",
        "roomType": "channel",
        "roomURL": "https://dc.dynamitecircle.com/channel/room1"
      },
      {
        "badgeCount": 7,
        "roomID": "room2",
        "roomName": "Jane Doe",
        "roomType": "direct",
        "roomURL": "https://dc.dynamitecircle.com/inbox/room2"
      }
    ],
    "totalUnread": 12
  },
  "ok": true
}

Rooms

GET /rooms — List your subscribed rooms

Returns rooms you are subscribed to or are a member of, sorted by last activity.

Query parameters

  • type string default:

    Filter by room type

  • limit number default: 50

    Max results (1-100)

Response

  • rooms object[]

    Array of rooms

    • roomID string

      Room ID

    • type string

      Room type

      Values: channel, direct, group, discussion, activity, event, city, country, mastermind

    • roomURL string

      Link to room on DC

    • scope string

      Community scope

      Values: dc, dcb

    • name string

      Room name

    • description string

      Room description

    • lastActivityAt string

      Last activity timestamp (ISO 8601)

    • stats object

      Room stats

      • comments number

        Total comments

      • reactions number

        Total reactions

      • subscribers number

        Subscriber count

GET /rooms/browse — Browse public channels

Returns browsable public channels and discussions. Use this to discover rooms to subscribe to.

Query parameters

  • type string default:

    Filter by room type (channel, discussion, activity)

  • limit number default: 50

    Max results (1-100)

Response

  • rooms object[]

    Array of browsable rooms

Locator

GET /locator/digest — Get locator digest

Returns your weekly locator digest — the same data that powers the Friday locator email. Use this to surface trip/event activity around the people and cities a member already follows. The response is composed of four independent sections; pass `?sections=<csv>` to skip any you don't need. Each section is described in full below. - **`homeCity`** — Activity in the city you have set as your home chapter. Null if you have no home city, or if you don't belong to any chapter yet. - **`favoriteCities`** — Per-city digest for cities you have favorited (besides your home city). Each entry lists upcoming trips/events into that city + new ones added since last week. - **`favoritePeople`** — Recent activity from members you follow: their new trips, upcoming trips, recently purchased tickets, and events they've RSVPd to. - **`myTrips`** — For each of your own upcoming trips, the people you're likely to overlap with (chapter leads, local members, and other DCers visiting the same city in the same window). Pass a comma-separated subset to `?sections=...` to omit sections you don't use — useful for narrow integrations and faster responses.

Query parameters

  • sections string

    Comma-separated list of sections to include. Defaults to all four sections when omitted.

Response

  • homeCity object

    Activity in your home chapter's city. `null` if you don't have a home city set, or if your profile is not associated with any chapter.

    • cityID string

      Google Place ID of the home city

    • cityName string

      Home city name

    • comingToCity object[]

      Members visiting your home city soon (their trips overlap with you here).

      • tripID string

        Trip ID

      • startDate string

        Start date (ISO 8601)

      • endDate string

        End date (ISO 8601)

      • location object

        Destination location. Null if the trip has no resolved place.

        • city string

          City name

        • country string

          Country

        • countryCode string

          ISO country code

        • name string

          Display name (e.g. "Tokyo, Japan")

      • member object

        Trip owner — minimal profile info for linking. Always at least `{ userID }`.

        • userID string

          Member ID

        • userName string

          DC username (used in profile URL)

        • displayName string

          Display name

        • photo string

          Profile photo URL

        • profileURL string

          Link to the member's public profile on DC

      • note string

        Free-form note the trip owner attached to the trip.

    • planningToCity object[]

      Members planning future trips into your home city (further out).

      • tripID string

        Trip ID

      • startDate string

        Start date (ISO 8601)

      • endDate string

        End date (ISO 8601)

      • location object

        Destination location. Null if the trip has no resolved place.

        • city string

          City name

        • country string

          Country

        • countryCode string

          ISO country code

        • name string

          Display name (e.g. "Tokyo, Japan")

      • member object

        Trip owner — minimal profile info for linking. Always at least `{ userID }`.

        • userID string

          Member ID

        • userName string

          DC username (used in profile URL)

        • displayName string

          Display name

        • photo string

          Profile photo URL

        • profileURL string

          Link to the member's public profile on DC

      • note string

        Free-form note the trip owner attached to the trip.

    • comingEvents object[]

      Upcoming events happening in your home city.

      • eventID string

        Event ID

      • name string

        Event name

      • eventType string

        Event type

      • eventURL string

        Link to the event page on DC

      • startDate string

        Event start date (ISO 8601)

      • endDate string

        Event end date (ISO 8601)

      • city object

        Host city

        • name string

          City name

        • country string

          Country

        • countryCode string

          ISO country code

        • placeID string

          Google Place ID

    • createdEvents object[]

      Events you have created or are hosting in this city.

      • eventID string

        Event ID

      • name string

        Event name

      • eventType string

        Event type

      • eventURL string

        Link to the event page on DC

      • startDate string

        Event start date (ISO 8601)

      • endDate string

        Event end date (ISO 8601)

      • city object

        Host city

        • name string

          City name

        • country string

          Country

        • countryCode string

          ISO country code

        • placeID string

          Google Place ID

    • newMembers object[]

      Members who have recently joined your home chapter.

      • userID string

        Member ID

      • userName string

        DC username (used in profile URL)

      • displayName string

        Display name

      • photo string

        Profile photo URL

      • profileURL string

        Link to the member's public profile on DC

  • favoriteCities object[]

    Per-city digest for each city you have favorited. Excludes your home city. Order is server-defined (typically by upcoming activity).

    • cityID string

      Google Place ID of the city

    • cityName string

      City name

    • country string

      Country

    • countryCode string

      ISO country code

    • comingTrips object[]

      Members with active or upcoming trips into this city.

      • tripID string

        Trip ID

      • startDate string

        Start date (ISO 8601)

      • endDate string

        End date (ISO 8601)

      • location object

        Destination location. Null if the trip has no resolved place.

        • city string

          City name

        • country string

          Country

        • countryCode string

          ISO country code

        • name string

          Display name (e.g. "Tokyo, Japan")

      • member object

        Trip owner — minimal profile info for linking. Always at least `{ userID }`.

        • userID string

          Member ID

        • userName string

          DC username (used in profile URL)

        • displayName string

          Display name

        • photo string

          Profile photo URL

        • profileURL string

          Link to the member's public profile on DC

      • note string

        Free-form note the trip owner attached to the trip.

    • newTrips object[]

      Trips into this city that were newly added since your last digest.

      • tripID string

        Trip ID

      • startDate string

        Start date (ISO 8601)

      • endDate string

        End date (ISO 8601)

      • location object

        Destination location. Null if the trip has no resolved place.

        • city string

          City name

        • country string

          Country

        • countryCode string

          ISO country code

        • name string

          Display name (e.g. "Tokyo, Japan")

      • member object

        Trip owner — minimal profile info for linking. Always at least `{ userID }`.

        • userID string

          Member ID

        • userName string

          DC username (used in profile URL)

        • displayName string

          Display name

        • photo string

          Profile photo URL

        • profileURL string

          Link to the member's public profile on DC

      • note string

        Free-form note the trip owner attached to the trip.

    • comingEvents object[]

      Events upcoming in this city.

      • eventID string

        Event ID

      • name string

        Event name

      • eventType string

        Event type

      • eventURL string

        Link to the event page on DC

      • startDate string

        Event start date (ISO 8601)

      • endDate string

        Event end date (ISO 8601)

      • city object

        Host city

        • name string

          City name

        • country string

          Country

        • countryCode string

          ISO country code

        • placeID string

          Google Place ID

    • newEvents object[]

      Events newly added in this city since your last digest.

      • eventID string

        Event ID

      • name string

        Event name

      • eventType string

        Event type

      • eventURL string

        Link to the event page on DC

      • startDate string

        Event start date (ISO 8601)

      • endDate string

        Event end date (ISO 8601)

      • city object

        Host city

        • name string

          City name

        • country string

          Country

        • countryCode string

          ISO country code

        • placeID string

          Google Place ID

  • favoritePeople object

    Activity from members you follow (favorited people). Each sub-array is independent — a member can appear in more than one.

    • newTrips object[]

      New trips your favorited people have added since the last digest.

      • tripID string

        Trip ID

      • startDate string

        Start date (ISO 8601)

      • endDate string

        End date (ISO 8601)

      • location object

        Destination location. Null if the trip has no resolved place.

        • city string

          City name

        • country string

          Country

        • countryCode string

          ISO country code

        • name string

          Display name (e.g. "Tokyo, Japan")

      • member object

        Trip owner — minimal profile info for linking. Always at least `{ userID }`.

        • userID string

          Member ID

        • userName string

          DC username (used in profile URL)

        • displayName string

          Display name

        • photo string

          Profile photo URL

        • profileURL string

          Link to the member's public profile on DC

      • note string

        Free-form note the trip owner attached to the trip.

    • comingTrips object[]

      Upcoming trips your favorited people have planned.

      • tripID string

        Trip ID

      • startDate string

        Start date (ISO 8601)

      • endDate string

        End date (ISO 8601)

      • location object

        Destination location. Null if the trip has no resolved place.

        • city string

          City name

        • country string

          Country

        • countryCode string

          ISO country code

        • name string

          Display name (e.g. "Tokyo, Japan")

      • member object

        Trip owner — minimal profile info for linking. Always at least `{ userID }`.

        • userID string

          Member ID

        • userName string

          DC username (used in profile URL)

        • displayName string

          Display name

        • photo string

          Profile photo URL

        • profileURL string

          Link to the member's public profile on DC

      • note string

        Free-form note the trip owner attached to the trip.

    • purchased object[]

      Tickets your favorited people have recently purchased.

      • eventID string

        Event ID the ticket is for

      • eventName string

        Event name

      • eventURL string

        Link to the event page on DC

      • startDate string

        Event start date (ISO 8601)

      • endDate string

        Event end date (ISO 8601)

      • member object

        Member who owns the ticket

        • userID string

          Member ID

        • userName string

          DC username (used in profile URL)

        • displayName string

          Display name

        • photo string

          Profile photo URL

        • profileURL string

          Link to the member's public profile on DC

    • attending object[]

      Events your favorited people are attending (RSVPd).

      • eventID string

        Event ID the ticket is for

      • eventName string

        Event name

      • eventURL string

        Link to the event page on DC

      • startDate string

        Event start date (ISO 8601)

      • endDate string

        Event end date (ISO 8601)

      • member object

        Member who owns the ticket

        • userID string

          Member ID

        • userName string

          DC username (used in profile URL)

        • displayName string

          Display name

        • photo string

          Profile photo URL

        • profileURL string

          Link to the member's public profile on DC

  • myTrips object[]

    For each of your own upcoming trips, the people you're likely to overlap with at the destination. Useful for "who can I meet on this trip" prompts.

    • trip object

      Your trip

      • tripID string

        Trip ID

      • startDate string

        Start date (ISO 8601)

      • endDate string

        End date (ISO 8601)

      • location object

        Destination location. Null if the trip has no resolved place.

        • city string

          City name

        • country string

          Country

        • countryCode string

          ISO country code

        • name string

          Display name (e.g. "Tokyo, Japan")

      • member object

        Trip owner — minimal profile info for linking. Always at least `{ userID }`.

        • userID string

          Member ID

        • userName string

          DC username (used in profile URL)

        • displayName string

          Display name

        • photo string

          Profile photo URL

        • profileURL string

          Link to the member's public profile on DC

      • note string

        Free-form note the trip owner attached to the trip.

    • cityID string

      Google Place ID of the trip's destination city

    • cityName string

      Destination city name

    • chapterLeads object[]

      DC chapter leads / city ambassadors for the destination city.

      • userID string

        Member ID

      • userName string

        DC username

    • localMembers object[]

      DC members who live in the destination city.

      • userID string

        Member ID

      • userName string

        DC username

    • plannedTrips object[]

      Other DCers planning trips that overlap with yours in this city/window.

      • tripID string

        Trip ID

      • startDate string

        Start date (ISO 8601)

      • endDate string

        End date (ISO 8601)

      • location object

        Destination location. Null if the trip has no resolved place.

        • city string

          City name

        • country string

          Country

        • countryCode string

          ISO country code

        • name string

          Display name (e.g. "Tokyo, Japan")

      • member object

        Trip owner — minimal profile info for linking. Always at least `{ userID }`.

        • userID string

          Member ID

        • userName string

          DC username (used in profile URL)

        • displayName string

          Display name

        • photo string

          Profile photo URL

        • profileURL string

          Link to the member's public profile on DC

      • note string

        Free-form note the trip owner attached to the trip.

Example: Fetch only home-city + people activity

{
  "sections": "homeCity,favoritePeople"
}
{
  "data": {
    "favoritePeople": {
      "attending": [],
      "comingTrips": [],
      "newTrips": [],
      "purchased": []
    },
    "homeCity": null
  },
  "ok": true
}

GET /locator/settings — Get your Friday locator email settings

Returns the four toggles that control the Friday locator email digest. The digest is a weekly outbound email surfacing new events, tickets, and trips relevant to you.

Response

  • locatorSettings object

    Friday locator email toggles

    • enabled boolean

      Master toggle for the Friday email digest

    • events boolean

      Include new events in your area

    • tickets boolean

      Include DCers you follow getting event tickets

    • trips boolean

      Include new trips to your area

Example: Default locator-email settings

{
  "data": {
    "locatorSettings": {
      "enabled": true,
      "events": true,
      "tickets": false,
      "trips": true
    }
  },
  "ok": true
}

PATCH /locator/settings — Update your Friday locator email settings

Update any subset of the Friday locator email toggles. Send only the fields you want to change.

Request body

  • enabled boolean

    Master toggle for the Friday digest

  • events boolean

    Include new events in your area

  • tickets boolean

    Include DCers you follow getting event tickets

  • trips boolean

    Include new trips to your area

Response

  • updated boolean

    `true` when the patch landed

Example: Disable the Friday locator email entirely

{
  "enabled": false
}
{
  "data": {
    "updated": true
  },
  "ok": true
}

Places

GET /places/:placeID — Get place details

Fetch full details for one Google Place ID. Useful for verifying a placeID before sending it to POST /trips.

Path parameters

  • placeID e.g. ChIJ51cu8IcbXWARiRtXIothAS4

    Google Place ID

Response

  • place object

    Place details

Chapters

GET /chapters — List chapters

List all DC chapters (city-based community hubs). Each chapter has a Google Place ID — pass it to `POST /trips` to create a trip to that chapter's city.

Query parameters

  • limit number default: 50

    Max chapters to return (1-100)

Response

  • chapters object[]

    Array of chapters

    • cityID string

      Chapter ID (same as the Google Place ID)

    • cityName string

      City name

    • country string

      Country

    • countryCode string

      ISO country code

    • placeID string

      Google Place ID — pass to POST /trips to create a trip to this city

    • memberCount number

      Number of members in this chapter

    • upcomingTrips number

      Number of upcoming trips to this chapter

    • chapterURL string

      Link to chapter page on DC

Example: List chapters

{
  "data": {
    "chapters": [
      {
        "chapterURL": "https://dc.dynamitecircle.com/chapter/ChIJ82ENKDJgHTERIEjiXbIAAQE",
        "cityID": "ChIJ82ENKDJgHTERIEjiXbIAAQE",
        "cityName": "Bangkok",
        "country": "Thailand",
        "countryCode": "TH",
        "memberCount": 142,
        "placeID": "ChIJ82ENKDJgHTERIEjiXbIAAQE",
        "upcomingTrips": 18
      }
    ]
  },
  "ok": true
}

GET /chapters/:cityID — Get a single chapter

Get full details for a single chapter, including up to 100 members.

Path parameters

  • cityID e.g. ChIJ82ENKDJgHTERIEjiXbIAAQE

    Chapter ID (same as Google Place ID)

Response

  • chapter object

    Chapter details

  • members object[]

    Members in this chapter (limited to first 100)

Membership

GET /membership — Get your membership state

Returns your full membership state: role, lifecycle dates, trial status, billing/subscription details, and a link to the Stripe Customer Portal where you can manage your subscription, payment methods, and download invoices.

Response

  • membership object

    Full membership state

    • userID string

      Member ID

    • joinedDate string

      Earliest membership start date (ISO 8601).

    • role object

      Role label + machine-readable key

      • label string

        Human-readable role label, e.g. "DC Red", "DC BLACK"

      • key string

        Stable key: red | black | free | trial | event-guest | inactive | admin | unknown

    • isActive boolean

      Whether the member is currently active

    • isStaff boolean

      Member is on the DC team

    • isAdmin boolean

      Member has admin privileges

    • isExpired boolean

      Membership has expired

    • isCanceled boolean

      Membership has been canceled

    • isInactive boolean

      Member is inactive

    • dcBlack object

      DC BLACK tier membership state

      • isMember boolean

        Currently a DC BLACK member

      • joinedDate string

        When the member joined DC BLACK (ISO)

      • leftDate string

        When the member left DC BLACK (ISO)

    • trial object

      Trial state (if any)

      • isOnTrial boolean

        Currently on a trial

      • wasOnTrial boolean

        Has been on a trial in the past

      • mode string

        Trial mode: manual | stripe | none

      • startDate string

        Trial start (ISO)

      • endDate string

        Trial end (ISO)

      • daysLeft number

        Days remaining in trial

      • duration number

        Total trial duration in days

      • progressPct number

        Trial progress 0–100

    • billing object

      Billing / subscription details

      • status string

        Subscription status: active | trialing | past_due | unpaid | canceled | paused | incomplete | incomplete_expired | no_subscription | free | scheduled | chargify | paypal

      • provider string

        Payment provider: stripe | paypal | chargify | free | none

      • isStripe boolean

        Member is billed via Stripe

      • isPaypal boolean

        Member is on legacy PayPal billing

      • isChargify boolean

        Member is on legacy Chargify billing

      • amount number

        Recurring amount in the smallest currency unit (e.g. cents)

      • amountFormatted string

        Pre-formatted amount, e.g. "$999.00"

      • currency string

        ISO 4217 currency code, e.g. "USD"

      • interval string

        Billing interval base unit, e.g. "month", "year"

      • intervalCount number

        Interval multiplier, e.g. 3 for quarterly

      • frequency string

        Plan frequency: annual | monthly | quarterly | semiannual | biennial | triennial | quinquennial

      • planName string

        Plan name, e.g. "DC Red — Annual"

      • planDescription string

        Plan description

      • currentPeriodStart string

        Current billing period start (ISO)

      • currentPeriodEnd string

        Current billing period end (ISO)

      • currentPeriodNo number

        Which billing period we are on

      • currentPeriodPct number

        Progress through the current period (0–100)

      • nextBillingDate string

        Next renewal/charge date (ISO). Same as currentPeriodEnd in most cases.

      • daysTillRenewal number

        Days until the next charge

      • subscriptionStartDate string

        When the subscription started (ISO)

      • subscriptionEndDate string

        When the subscription ended (ISO, if it has)

      • memberPeriodNo number

        Number of completed renewals

      • hasMultipleSubscriptions boolean

        True if the member has 2+ active subscriptions

      • totalSubscriptions number

        Total active subscription count

    • links object

      Useful URLs

      • manageBillingURL string

        Stripe Customer Portal login URL — manage subscription, payment methods, download invoices. Null for legacy paypal/chargify members.

      • profileURL string

        Public profile URL

Example: Active member with Stripe annual subscription

{
  "data": {
    "membership": {
      "billing": {
        "amount": 99900,
        "amountFormatted": "$999.00",
        "currency": "USD",
        "currentPeriodEnd": "2026-11-15T00:00:00.000Z",
        "currentPeriodNo": 8,
        "currentPeriodPct": 47,
        "currentPeriodStart": "2025-11-15T00:00:00.000Z",
        "daysTillRenewal": 195,
        "frequency": "annual",
        "hasMultipleSubscriptions": false,
        "interval": "year",
        "intervalCount": 1,
        "isChargify": false,
        "isPaypal": false,
        "isStripe": true,
        "memberPeriodNo": 8,
        "nextBillingDate": "2026-11-15T00:00:00.000Z",
        "planDescription": "Yearly DC membership",
        "planName": "DC Red — Annual",
        "provider": "stripe",
        "status": "active",
        "subscriptionEndDate": null,
        "subscriptionStartDate": "2018-04-12T00:00:00.000Z",
        "totalSubscriptions": 1
      },
      "dcBlack": {
        "isMember": false,
        "joinedDate": null,
        "leftDate": null
      },
      "isActive": true,
      "isAdmin": false,
      "isCanceled": false,
      "isExpired": false,
      "isInactive": false,
      "isStaff": false,
      "joinedDate": "2018-04-12T00:00:00.000Z",
      "links": {
        "manageBillingURL": "https://billing.stripe.com/p/login/28o2ayfjS2MTfaE4gg",
        "profileURL": "https://www.dynamitecircle.com/profile/peter"
      },
      "role": {
        "key": "red",
        "label": "DC Red"
      },
      "trial": {
        "daysLeft": null,
        "duration": null,
        "endDate": null,
        "isOnTrial": false,
        "mode": "none",
        "progressPct": null,
        "startDate": null,
        "wasOnTrial": true
      },
      "userID": "8wYpQz3KxRm7sNvL2bH9"
    }
  },
  "ok": true
}

GET /membership/invoices — List your Stripe invoices

Returns your Stripe invoices, newest first. Each entry includes a hosted-invoice URL and a PDF link, both safe to share — perfect for self-serve receipts. Returns an empty array for legacy paypal/chargify members or members with no Stripe customer.

Query parameters

  • limit number default: 20

    Max results (1-100)

Response

  • invoices object[]

    Array of Stripe invoices, newest first

    • invoiceID string

      Stripe invoice ID

    • number string

      Human invoice number, e.g. "DC-0042"

    • status string

      Status: draft | open | paid | uncollectible | void

    • amount number

      Total amount in the smallest currency unit (e.g. cents)

    • amountFormatted string

      Pre-formatted amount, e.g. "$999.00"

    • currency string

      ISO 4217 currency code

    • paid boolean

      True if the invoice is fully paid

    • date string

      Invoice creation date (ISO 8601)

    • periodStart string

      Billing period start (ISO 8601)

    • periodEnd string

      Billing period end (ISO 8601)

    • hostedInvoiceURL string

      Hosted invoice page — safe to share, used for online payment + receipt download

    • invoicePDF string

      Direct PDF link to the invoice

    • description string

      Plan / line-item description

Example: List your invoices

{
  "data": {
    "invoices": [
      {
        "amount": 99900,
        "amountFormatted": "$999.00",
        "currency": "USD",
        "date": "2025-11-15T12:00:00.000Z",
        "description": "DC Red — Annual",
        "hostedInvoiceURL": "https://invoice.stripe.com/i/acct_1.../invst_...",
        "invoiceID": "in_1OabCdEFGhijKL",
        "invoicePDF": "https://pay.stripe.com/invoice/.../pdf",
        "number": "DC-0042",
        "paid": true,
        "periodEnd": "2026-11-15T00:00:00.000Z",
        "periodStart": "2025-11-15T00:00:00.000Z",
        "status": "paid"
      }
    ]
  },
  "ok": true
}

Notifications

GET /notifications — Get your notification preferences

Returns your push + email preferences per notification category. Defaults are applied for any preference you have never explicitly set. Email is `null` for `reaction` / `myReaction` because email is not supported for those categories. For the Friday locator email digest, see `GET /profile/locator-settings` — that's a separate concern (outbound digest, not per-event push/email).

Response

  • notifications object

    Notification preferences

    • categories object

      Push + email toggle per category. 12 categories: account, activity, announcement, channel, chat, directMessage, discussion, event, mention, myReaction, photoTag, reaction. `email` is `null` for reaction/myReaction (not supported).

Example: Default notification preferences

{
  "data": {
    "notifications": {
      "categories": {
        "account": {
          "email": true,
          "push": true
        },
        "activity": {
          "email": false,
          "push": true
        },
        "announcement": {
          "email": true,
          "push": true
        },
        "channel": {
          "email": true,
          "push": true
        },
        "chat": {
          "email": true,
          "push": true
        },
        "directMessage": {
          "email": true,
          "push": true
        },
        "discussion": {
          "email": false,
          "push": true
        },
        "event": {
          "email": false,
          "push": true
        },
        "mention": {
          "email": true,
          "push": true
        },
        "myReaction": {
          "email": null,
          "push": true
        },
        "photoTag": {
          "email": false,
          "push": true
        },
        "reaction": {
          "email": null,
          "push": false
        }
      }
    }
  },
  "ok": true
}

PATCH /notifications — Update your notification preferences

Update any subset of your notification preferences. Send only the categories/channels you want to change — the rest stay as-is. Email is rejected for `reaction` / `myReaction` (not supported).

Request body

  • categories object required

    Per-category push/email toggles. Pass only the categories + channels you want to change.

Response

  • updated boolean

    `true` when the patch landed

Example: Disable announcement emails + enable reaction push

{
  "categories": {
    "announcement": {
      "email": false
    },
    "reaction": {
      "push": true
    }
  }
}
{
  "data": {
    "updated": true
  },
  "ok": true
}

Calendar

GET /calendar — Get your iCalendar feed URL + settings

Returns your iCalendar feed URLs and the toggles that control which event categories the feed includes. **Three URLs are returned:** - `httpsURL` — paste into any calendar app that accepts an HTTPS subscription - `webcalURL` — same URL with the `webcal://` scheme; macOS / iOS Calendar opens it directly - `googleURL` — one-click Google Calendar subscribe link The feed includes events you have tickets to, virtual calls, your trips, chapter events, and flagship events — exactly what each `include*` toggle below controls. Tokens are deterministic, so the URLs never change for a given member.

Response

  • calendar object

    Calendar feed URLs + content toggles

    • feed object

      Three subscription URLs for the same feed

      • httpsURL string

        HTTPS URL — works in most calendar apps

      • webcalURL string

        `webcal://` URL — macOS / iOS Calendar opens this directly

      • googleURL string

        Google Calendar one-click subscribe link

    • toggles object

      Booleans controlling what shows up in the feed (all default sensible).

      • includeMyTickets boolean

        Events you have a valid ticket to

      • includeEventAgenda boolean

        Sessions + meetups bookmarked on your event agenda

      • includeVirtualCalls boolean

        Virtual calls (Connect Calls, DC BLACK calls, welcome calls, happy hours)

      • includeMyTrips boolean

        Your posted trips

      • includeFlagshipEvents boolean

        DCBKK + DCMEX flagship events

      • includeDCBlackEvents boolean

        DC BLACK retreats

      • includeHomeChapterEvents boolean

        Events from your home chapter

      • includeFollowedChapterEvents boolean

        Events from chapters you follow

      • includeOtherChapterEvents boolean

        Events from chapters you don't belong to (DCX, global)

Example: Default calendar feed configuration

{
  "data": {
    "calendar": {
      "feed": {
        "googleURL": "https://calendar.google.com/calendar/r?cid=https%3A%2F%2Fdc.dynamitecircle.com%2Fcal%2F8wYpQz3KxRm7sNvL2bH9%2Fa1b2c3d4e5f6g7h8i9j0k1l2.ics",
        "httpsURL": "https://dc.dynamitecircle.com/cal/8wYpQz3KxRm7sNvL2bH9/a1b2c3d4e5f6g7h8i9j0k1l2.ics",
        "webcalURL": "webcal://dc.dynamitecircle.com/cal/8wYpQz3KxRm7sNvL2bH9/a1b2c3d4e5f6g7h8i9j0k1l2.ics"
      },
      "toggles": {
        "includeDCBlackEvents": false,
        "includeEventAgenda": true,
        "includeFlagshipEvents": true,
        "includeFollowedChapterEvents": true,
        "includeHomeChapterEvents": true,
        "includeMyTickets": true,
        "includeMyTrips": false,
        "includeOtherChapterEvents": false,
        "includeVirtualCalls": true
      }
    }
  },
  "ok": true
}

PATCH /calendar — Update calendar feed settings

Update any subset of your calendar feed toggles. Send only the toggles you want to change. Returns the updated toggle set plus the feed URLs (which never change).

Request body

  • includeDCBlackEvents boolean

    Boolean

  • includeEventAgenda boolean

    Boolean

  • includeFlagshipEvents boolean

    Boolean

  • includeFollowedChapterEvents boolean

    Boolean

  • includeHomeChapterEvents boolean

    Boolean

  • includeMyTickets boolean

    Boolean

  • includeMyTrips boolean

    Boolean

  • includeOtherChapterEvents boolean

    Boolean

  • includeVirtualCalls boolean

    Boolean

Response

  • updated boolean

    `true` when the patch landed

Example: Add DC BLACK retreats + your trips to the feed

{
  "includeDCBlackEvents": true,
  "includeMyTrips": true
}
{
  "data": {
    "updated": true
  },
  "ok": true
}

Limits

GET /limits — Get your effective rate limits + current usage

Returns the effective per-minute and per-day rate limits for your API key, **plus current usage** (how many calls you have already made in the current minute and day windows, when each window resets, and how many calls you have left). Limits derive from your membership tier (DC member: 10/min, 300/day; DC BLACK member and staff: 60/min, 3000/day) unless an admin has set per-key overrides — overrides win when present. The same usage data is also exposed on every API response via the `X-RateLimit-Remaining`, `X-RateLimit-Reset`, `X-RateLimit-Daily-Remaining`, and `X-RateLimit-Daily-Reset` headers. Use this endpoint when you want a JSON snapshot, or the headers when you want to read it on every call.

Response

  • tier string

    Your membership tier (`dcc` or `dcb`). Admins are reported as `dcb`.

    Values: dcc, dcb

  • perMinute number

    Effective per-minute request cap.

  • perDay number

    Effective per-day request cap.

  • tierDefaults object

    The tier defaults — what your limits would be without overrides.

    • perMinute number

      Tier-default per-minute cap

    • perDay number

      Tier-default per-day cap

  • overrides object

    Per-key overrides set by an admin. Each field is the override value (taking precedence over tier default) or `null` when not overridden.

    • perMinute number

      Per-minute override (null = use tier default)

    • perDay number

      Per-day override (null = use tier default)

  • usage object

    Current usage in the active windows. Counts include this very request (the rate-limit middleware increments before this handler runs).

    • minuteUsed number

      Calls already made in the current minute window

    • minuteResetAt string

      When the per-minute window resets (ISO 8601)

    • dailyUsed number

      Calls already made today (UTC day window)

    • dailyResetAt string

      When the per-day window resets (ISO 8601)

    • remaining object

      Calls left before you hit the cap (clamped to 0).

      • perMinute number

        Calls left in the current minute

      • perDay number

        Calls left today

Example: DC BLACK member, no overrides, 3 calls this minute / 127 today

{
  "data": {
    "overrides": {
      "perDay": null,
      "perMinute": null
    },
    "perDay": 3000,
    "perMinute": 60,
    "tier": "dcb",
    "tierDefaults": {
      "perDay": 3000,
      "perMinute": 60
    },
    "usage": {
      "dailyResetAt": "2026-05-01T00:00:00.000Z",
      "dailyUsed": 127,
      "minuteResetAt": "2026-04-30T15:42:00.000Z",
      "minuteUsed": 3,
      "remaining": {
        "perDay": 2873,
        "perMinute": 57
      }
    }
  },
  "ok": true
}

Discovery

POST /profile-match — Match DCers from a description (or recommend if omitted)

**AI-powered profile matchmaker.** Match DCers against a natural-language description, or — when `query` is omitted — recommend DCers based on your own profile (chapter, industry, expertise, goals). Returns ranked results from a profile-vector search (Gemini embeddings + reranking under the hood). The caller's LLM synthesizes any narrative on top. Stricter rate limits than the standard CRUD endpoints because of the embedding/rerank cost. **Two modes**: - **With `query`**: free-form description ("DCers in Lisbon who run SaaS"). - **Without `query`**: AI builds an implicit query from your profile and returns "DCers you should meet". Useful for cold-start "who should I message this week?" prompts. **Optional structured filters** (combine with either mode, all AND-ed): - `locationChapterPlaceID` — narrow to DCers whose home / base location matches this Google Place ID. Use for "based in X" queries. Resolve via `GET /places/search`. - `locationCurrentPlaceID` — narrow to DCers currently in this place (auto-derived from their last GPS / active trip). Use for "currently in X" / "visiting X" queries. - `eventID` — narrow to DCers holding a valid ticket to this event ("DCers attending DCMEX who run logistics"). Refunded / canceled tickets are excluded. - `isDCB` — when `true`, narrow to DC BLACK members only.

Request body

  • query string

    Free-form description of the DCers you want to find. Omit to get recommendations based on your own profile.

  • locationChapterPlaceID string

    Optional. Google Place ID — narrows results to DCers based here ("based in X"). Resolve via `GET /places/search`.

  • locationCurrentPlaceID string

    Optional. Google Place ID — narrows results to DCers currently here, whether they live there or are visiting. Resolve via `GET /places/search`.

  • eventID string

    Optional. DC event ID — narrows results to DCers with a valid ticket (RSVP yes/maybe or paid). Pair with `query` for "DCers attending X who do Y".

  • isDCB boolean

    Optional. When `true`, narrows results to DC BLACK members only.

  • limit number

    Max results (1-20, default 20). Hard cap at 20 — match is expensive; narrow with filters instead of paginating.

Response

  • results object[]

    Ranked profile matches, highest score first

    • score number

      Match score (0-1, higher = better match)

    • profile object

      Standard profile object — DC BLACK callers also get businessDescription, businessUrl, revenue, teamSize

Example: Match by description

{
  "limit": 5,
  "query": "DCers in Lisbon who run SaaS"
}
{
  "data": {
    "results": [
      {
        "profile": {
          "chapter": {
            "chapterURL": "https://www.dynamitecircle.com/chapters/lisbon-pt",
            "cityName": "Lisbon",
            "country": "Portugal",
            "countryCode": "PT",
            "placeID": "ChIJ-ZRLfIQzMBQR2bAQQ8sZh90"
          },
          "displayName": "Jane Doe",
          "headline": "Founder, Acme SaaS",
          "industry": "SaaS / Software",
          "joinedDate": "2020-04-12",
          "photo": "https://cdn.dynamitecircle.com/profiles/jane.jpg",
          "profileURL": "https://www.dynamitecircle.com/profile/JaneDoe",
          "userID": "1234",
          "userName": "JaneDoe"
        },
        "score": 0.91
      }
    ]
  },
  "ok": true
}

Example: Recommend (no query — based on your profile)

{
  "limit": 5
}
{
  "data": {
    "results": [
      {
        "profile": {},
        "score": 0.87
      }
    ]
  },
  "ok": true
}

Issues

POST /report-issue — Report an issue or feedback

Submit a bug report, feedback, or question to the DC team. Optionally include a base64-encoded screenshot (PNG, JPEG, or WebP, up to 4 MB raw). **Privacy note:** Screenshots and report text are sent unredacted to the DC team. Don't include passwords, payment details, or other secrets.

Request body

  • text string required

    A short description of the issue or feedback (1–4000 chars).

  • severity string

    Severity: bug | feedback | question. Defaults to "bug".

  • screenshot string

    Optional base64-encoded screenshot. Accepts raw base64 OR a data URL (e.g. `data:image/png;base64,...`). PNG, JPEG, or WebP only. Max 4 MB raw, clamped to 4096×4096; re-encoded server-side to strip EXIF.

  • context object

    Optional structured debug context — anything useful for triage (last error, request payload, endpoint, etc.). Up to 32 keys.

Response

  • data object

    Acknowledgement

    • issueID string

      Server-assigned issue ID

    • submittedAt string

      When the report was received (ISO 8601)

Example: Report a bug

{
  "context": {
    "endpoint": "POST /trips",
    "lastError": "place_lookup_failed"
  },
  "severity": "bug",
  "text": "POST /trips returns 502 when I pass a placeID for Mexico City"
}
{
  "data": {
    "issueID": "fdbk_abc123def456",
    "submittedAt": "2026-05-04T13:45:00.000Z"
  },
  "ok": true
}