# ALL Applied AI Network

> Public data API for student AI chapters. Each chapter's events, members, leaderboard, badges, merch, projects and learning-tree content are readable over HTTP and editable by that chapter's officers in their dashboard.

Base URL: https://dashboard.all-ai-network.org

## Read this first

- Every per-chapter module is available WITHOUT an API key through one endpoint: `GET /api/public/chapter/{slug}/bundle`. It is CORS-open and safe to call from a browser.
- If the site you are working on is static (no server at request or build time), use the public endpoints and do NOT introduce an API key. Bundlers inline environment variables (`VITE_*`, `NEXT_PUBLIC_*`, `REACT_APP_*`) into the JavaScript shipped to visitors, so a key placed there is published.
- The authenticated `/api/v1/*` endpoints are for sites that genuinely execute code on a server.
- Responses are edge-cached about 30 seconds. Fetch on page load; do not build a client-side cache.

## Public endpoints

- [Chapter bundle](https://dashboard.all-ai-network.org/api/public/chapter/{slug}/bundle): Everything a chapter website needs in one round-trip: identity and counts, presentation config, events, leaderboard, badges, merch, projects, and social feeds. This is the endpoint most integrations should use.
- [Learning tree](https://dashboard.all-ai-network.org/api/public/learning-tree/{slug}): The network's shared curriculum graph merged with the chapter's own nodes, as nodes and edges.
- [Chapter site config](https://dashboard.all-ai-network.org/api/public/config/{slug}): Just the presentation config — theme, logo, section toggles, officers — without the rest of the bundle.
- [Chapter directory](https://dashboard.all-ai-network.org/api/public/network/chapters): Every chapter that has opted into network discovery, with its university and hub site.
- [Network statistics](https://dashboard.all-ai-network.org/api/public/network-stats): Aggregate, no-PII snapshot of the network: chapter count, member totals, and partner activity.

## Chapter data modules

Each is a field on the bundle response above. Full descriptions and response shapes: https://dashboard.all-ai-network.org/docs

- **Hub-site configuration** (`config`): Fetch your chapter's theme colors, logo URL, and section toggles from the dashboard. Drives the site's CSS variables, header logo, and which components render.
- **Upcoming events** (`events`): Render your chapter's next events on your homepage. Auto-updates as you add events in the dashboard.
- **Leaderboard** (`leaderboard`): Show the top members by XP. Great for a homepage widget or a dedicated members page.
- **Chapter stats** (`chapter`): Pull your chapter's name, university, member count, and event count — perfect for a hero banner or footer.
- **Chapter badges** (`badges`): Render the full catalog of recognition badges your chapter awards — with their name, description, icon, and how many members have earned each one.
- **Merch catalog** (`merch`): Display the rewards your chapter offers in exchange for earned points — T-shirts, stickers, workshop vouchers — so members know what they're working toward.
- **Club social feed** (`social_feeds`): Latest public posts from the club's linked LinkedIn and Instagram accounts, synced on demand from the dashboard. Renders as a card grid; hides itself until the eboard has synced a feed.
- **Projects & research** (`projects`): The chapter's project and research history — each with its team, papers, slides, and recordings.
- **Learning tree**: The network's shared AI curriculum graph merged with this chapter's own nodes.

## Gotchas that cost people time

- `events` defaults to UPCOMING only. A chapter whose events are all past returns an empty array — pass `?events=all` for the archive and check the `events_scope` field before concluding there are none.
- `projects[].members` carries author bylines and `projects[].files` carries papers, slides and recordings. A project list without its people is a wall of titles.
- Learning-tree nodes carry `pos_x`/`pos_y` when an officer has arranged them by hand. Honour those; only auto-layout nodes without them. `prereqs` can name multiple parents — it is a graph, not a strict tree.
- `config` holds the chapter's dashboard theme and section toggles. If the site has its own design, ignore them rather than overwrite it.

## More

- [Full documentation](https://dashboard.all-ai-network.org/docs)
- [OpenAPI 3.1 specification](https://dashboard.all-ai-network.org/openapi.json)
- [Network site](https://all-ai-network.org)