Skip to content

Public GraphQL API

The Public API is how VenuePilot shares what's coming up with the outside world — a single, read-only feed of publicly announced events, along with their venues, artists, and cover imagery.

If you're building something that needs to answer "what's on at our venues this weekend?", "what have our partner accounts announced since yesterday?", or "give me every upcoming show across the venues we work with", this is the API you want.

What you get back

Every event comes with the information you'd need to render it on a website, in a mobile app, or in a newsletter:

  • Identifiers — stable id and human-readable slug for deduplication and URLs
  • Basic info — name, description, tags, support acts, promoter
  • When — start time, door time, end time (all ISO8601)
  • Where — the venue, with address, coordinates, timezone, and currency
  • Who — artists performing, each with name and external links
  • How much — minimum and maximum ticket prices
  • Statuscanceled and soldOut flags so you can render the current state
  • How to buy — the ticketing URL plus a custom button label and open-in hint
  • Visuals — event images in multiple named variants for different display contexts

Jump into the Reference for a concrete walkthrough of the endpoint, authentication, pagination, and worked examples — or browse the full schema in the Schema types index.

Three things to know before you start

  1. Read-only. There are no mutations. This is a feed, not a back-of-house tool — no ticket sales, no holds, no inventory.
  2. Events-first. A single root query returns a paginated list of events. Venues, artists, and images come out by walking an event's relationships.
  3. Account-scoped. Every request identifies itself with an application id, and that id is wired to a specific set of VenuePilot accounts at provisioning time. Aggregators and discovery networks that genuinely need platform-wide access use a documented opt-in wildcard — see EventSearchArguments in the Reference.

Getting access

Contact your VenuePilot account manager to request an application id. Once provisioned, you can make requests immediately — there are no per-user logins and no token exchange to wire up.