Public show data
Fetch published show data from HQ over HTTPS. The initial public API is read-only and does not need an account, token, or API key.
Start with a request
Use the production API base URL with the endpoint described in the show catalog guide:
curl --fail-with-body \
'https://api.b90hq.app/v1/public/shows?when=upcoming&limit=10'
The response is JSON. The catalog is public and cacheable, so requests do not include an Authorization header.
Both catalog endpoints are unauthenticated, read-only routes. Browser clients may call them
directly from any origin; GET and OPTIONS responses use Access-Control-Allow-Origin: *.
Current public surface
| Endpoint | Use |
|---|---|
GET /v1/artists/{username}/shows | Fetch published shows for a public artist username. |
GET /v1/public/shows | Fetch published shows with optional time, location, artist, and pagination filters. |
| Artist MCP | Authenticate a compatible MCP client to read and manage unpublished artist show drafts. |
The two catalog routes above are the unauthenticated, read-only public API surface. The separate authenticated Artist MCP guide documents the draft-only write surface. Other write operations, authenticated app routes, dashboard routes, and internal infrastructure are outside these documented surfaces.
Data visibility
The catalog contains published shows that are not hidden or deleted. It includes the event shell, public venue and time data, public artist rows, the public show URL and image URL when available, and the total RSVP count.
The API does not return private RSVP identities, moderation data, credentials, or dashboard-only fields. Use the field names and query parameters shown in the endpoint guides; fields outside this documented surface are not a supported contract.
API data use
You may use the published public show, artist, venue, schedule, and related public image URL data for public event listings, discovery, calendars, and integrations under the Terms of Service. You may copy, cache, transform, and display those documented fields. Follow the documented limits, keep source links or attribution supplied with the data, and stop using data that is no longer public. This permission does not cover private data, messages, unpublished material, moderation data, credentials, or unrelated user content. It does not grant rights in third-party names, images, marks, or works, and it does not permit building a competing social or community service.
Next steps
- Read the show catalog guide to fetch and paginate show rows.
- Read the artist shows guide to fetch shows for one artist.
- Read the Artist MCP guide to connect a compatible client to authenticated draft tools.
The Artist MCP is an authenticated remote surface. It is separate from the unauthenticated public read API above: it uses OAuth 2.1 browser consent, requires an eligible HQ artist account, and can only create or edit unpublished drafts for dashboard review.