Developer Platform

You don't need this. But you'll want it.

phosphorOS runs your venue out of the box. Zero integrations required. But if you want to build on top of it, extend it, or pipe data into your own systems — we built the most comprehensive developer platform in nightlife software. Not as an afterthought. As a first-class product.

API

Full REST API — 100% coverage.

If you can click it in the UI, you can call it from the API. Every module, every entity, every action. RESTful endpoints with consistent response schemas, cursor-based pagination, and comprehensive error codes.

Complete parity with the UI
No second-class endpoints. Reservations, tickets, guest lists, floor maps, commissions, schedules, contracts — every operation available via the same API the native apps use.
Versioned and stable
Semantic versioning with 12-month deprecation windows. Breaking changes are announced, documented, and never surprise you on a Saturday night.
Rate limiting with burst support
Generous rate limits with burst allowances for event-night traffic spikes. Rate limit headers on every response so your code can throttle gracefully.
Published SLA: 99.99% uptime, <100ms p95
We publish our latency and availability numbers because we're proud of them. p95 response times under 100ms. Backed by a real SLA with real credits.
GraphQL

Query exactly what you need. Nothing more.

A full GraphQL endpoint for teams that want to shape their own queries. Request only the fields you need, nest related objects in a single call, and subscribe to real-time changes over WebSocket.

Single-request data composition
Pull a reservation with its table, guest profile, host attribution, and commission calculation in one query. No more chaining five REST calls to build a single view.
Real-time subscriptions
Subscribe to entity changes over WebSocket. Get push updates when a table status changes, a ticket sells, or a guest checks in — the same real-time feed that powers the native apps.
Webhooks

200+ event types. HMAC-signed. Replayable.

Every meaningful state change in phosphorOS fires a webhook. Signed payloads, idempotency keys, automatic retries with exponential backoff, and a dead letter queue with one-click replay.

HMAC-SHA256 signed payloads
Every webhook payload is signed with your secret key. Verify authenticity before processing. Replay attacks are impossible — timestamps are included in the signature.
Idempotency keys on every event
Every webhook carries a unique idempotency key so your systems can safely deduplicate. Process once, ignore retries, never double-count a transaction.
Dead letter queue with replay
Failed deliveries land in a dead letter queue with full payload inspection. Fix your endpoint, hit replay, and every missed event redelivers in order. No data loss.
Granular event filtering
Subscribe to exactly the events you care about. Filter by domain, module, entity type, or specific action. Your endpoint only receives what it needs to process.
SDKs

Official SDKs. Four languages. Shared core types.

Swift, Python, TypeScript, and Ruby — distributed via SPM, PyPI, npm, and RubyGems. The same strongly-typed models the native apps use, available in your language of choice.

Swift (SPM)
First-class Swift package sharing core types with the iOS, iPadOS, macOS, watchOS, and tvOS apps. async/await native. Feels like an Apple framework because it's built like one.
Python (PyPI)
Type-hinted, async-ready Python SDK. pip install phosphoros and start querying in three lines. Built for data teams, automation scripts, and backend integrations.
TypeScript (npm)
Full TypeScript types with zero dependencies. Works in Node.js and edge runtimes. Every response is typed — your IDE knows the shape before you run the code.
Ruby (RubyGems)
Idiomatic Ruby gem for Rails integrations and scripting. Convention over configuration — sensible defaults, chainable queries, and automatic pagination.
Sandbox

50,000 guest profiles. 6 months of data. Time travel.

Every developer account gets a sandbox pre-loaded with realistic nightlife data. 50K guest profiles, full reservation histories, ticket sales, commission calculations, and tip distributions. Plus a time-travel mode that simulates peak Saturday night at 1 AM.

Realistic seed data
Not placeholder junk. Real-looking names, plausible spend patterns, seasonal trends, and event histories that mimic a high-volume Las Vegas nightclub. Build against data that behaves like production.
Time-travel mode
Set the sandbox clock to any date and time. Simulate a packed Saturday at 1 AM with real-time WebSocket events firing — table turns, bottle orders, capacity updates, commission calculations. Test your integration under pressure.
Resettable environments
Reset your sandbox to its original state with one API call. Run destructive tests, wipe clean, repeat. No fear of corrupting your test data.
Isolated per developer
Every developer on your team gets their own sandbox instance. No stepping on each other's data. No merge conflicts in your test environment.
CLI

phos — the terminal-native interface.

A CLI tool for developers who live in the terminal. Query any endpoint, pipe to jq, script your workflows. Install via Homebrew and authenticate in one command.

Homebrew installable
brew install phosphoros/tap/phos — one command, fully configured. Auto-updates, shell completions for zsh/bash/fish, and man pages included.
Pipeable JSON output
Every command outputs clean JSON by default. Pipe to jq, feed into scripts, chain with other CLI tools. phos tables list --status seated | jq '.[] | .spend'
Full CRUD operations
Create, read, update, and delete any entity from the command line. Manage reservations, check guest lists, pull commission reports — all without opening a browser.
Watch mode
phos watch tables — live-stream table status changes to your terminal. Real-time WebSocket data rendered as it happens. Debug integrations without leaving your editor.
Signage SDK

Build your own Apple TV experiences.

A SwiftUI template engine for building custom digital signage on Apple TV. Pull live data from phosphorOS — bottle menus, event lineups, VIP arrivals, capacity — and render it on screens throughout your venue.

SwiftUI templates
Pre-built SwiftUI components for common signage patterns — menus, event schedules, leaderboards, capacity meters. Customize the design, we handle the data binding.
Live data binding
Signage content updates in real time via the same WebSocket infrastructure that powers the floor map. Bottle sold? Menu updates. Capacity changes? The number on screen changes.
Data Export

Your data. Your warehouse. Your schedule.

Scheduled bulk exports in JSON, CSV, or Parquet — delivered directly to your S3 bucket, Snowflake instance, or BigQuery dataset. No ETL pipelines to build. No vendor lock-in.

Three export formats
JSON for flexibility, CSV for spreadsheets, Parquet for analytics warehouses. Pick the format that fits your stack. Change it anytime.
Direct warehouse delivery
Configure once and exports land in your S3 bucket, Snowflake, or BigQuery on schedule. Daily, weekly, or event-triggered. Your data arrives where your analysts already work.
Incremental and full exports
Choose full snapshots or incremental change feeds. Incremental exports include only records modified since the last run — efficient, fast, and warehouse-friendly.
Portal

Interactive docs. "Try It" on every endpoint.

A developer portal built by engineers who hate bad documentation. Every endpoint has a live "Try It" button that hits your sandbox. Request and response examples for every operation. No guessing.

Live API explorer
Click "Try It" on any endpoint and watch the request execute against your sandbox in real time. See the actual response, not a static example from six months ago.
Auto-generated from source
Documentation is generated directly from the API source code. When the API changes, the docs change. They're never out of date because they can't be.
Code samples in every language
Every endpoint includes working code samples in Swift, Python, TypeScript, Ruby, and cURL. Copy, paste, run. No translation required.
Guides and tutorials
Step-by-step guides for common integration patterns — POS sync, custom reporting, third-party reservation widgets, signage apps, and data warehouse pipelines.
Marketplace

OAuth 2.0 app marketplace. Revenue share included.

Build integrations that other venues can install with one click. Scoped OAuth 2.0 permissions, a review process that isn't a black hole, and a revenue share model that makes building on phosphorOS a real business.

Scoped OAuth 2.0 permissions
Apps request only the permissions they need. Venue operators see exactly what an app can access before installing. Granular scopes per module and per action.
One-click install for venues
Venues browse, review, and install marketplace apps without calling their developer. OAuth consent screen, permission grant, done. Live in minutes.
Revenue share
Charge venues a subscription or per-transaction fee for your app. phosphorOS handles billing, invoicing, and payouts. You build. We collect. You get paid.
Transparent review process
Submit your app, get feedback within 48 hours. Clear guidelines, no mystery rejections. We want more apps in the marketplace, not fewer.
Start Building

You don't need any of this.

phosphorOS runs your entire venue without a single line of custom code. But this is the most comprehensive developer platform in nightlife software. It's not an afterthought. It's built by engineers who would want to use it themselves.

See the full platform Request API Access