API overview
VenueOS gives you three ways to build on your venue's data. Every plan includes API access, which most ticketing platforms only offer to big partners, if at all.
| What it's for | Auth | |
|---|---|---|
| Embeds | Put ticket checkout and menus on your own website with one script tag | None (public) |
| Public read API | Published events and menus for your site or app | None (public, CORS-enabled) |
| REST API v1 | Your own data: events, orders, tickets, check-ins, guests, usage | API key |
Quick start (REST API v1)
- In VenueOS, open API in the sidebar (owners and venue managers) and create a key. Copy it; it's shown once.
- Call the API from your server:
curl https://app.venueos.justwhat.net/api/v1/events?upcoming=true \
-H "Authorization: Bearer vos_live_YOUR_KEY"
{
"data": [
{ "id": "4f6c…", "slug": "halloween-at-heritage-hall", "title": "Halloween at Heritage Hall", "status": "published", "starts_at": "2026-10-31T23:00:00Z", "capacity": 160 }
],
"has_more": false,
"next_cursor": null
}
- Base URL:
https://app.venueos.justwhat.net/api/v1 - Format: JSON, snake_case fields, ISO 8601 times in UTC, amounts in cents.
- Version: every response carries
X-VenueOS-Api-Version: 2026-11-01. Breaking changes ship as a new version with notice in the release notes.
What each plan includes
| Starter | Pro | Venue Group | Full access | |
|---|---|---|---|---|
| Requests per minute (per key) | 60 | 120 | 300 | Custom |
| Requests per month (per venue) | 10,000 | 100,000 | 1,000,000 | Custom |
| API keys | 2 | 5 | 20 | Custom |
| Venue, events, menus | ✓ | ✓ | ✓ | ✓ |
| Orders, tickets, check-ins | ✓ | ✓ | ✓ | |
| Guest profiles | ✓ | ✓ | ||
| Write access, partner integrations | ✓ |
Full details in Limits and plans. Need write access, higher volumes or a partner integration? Contact us for full API access.