Supergood | Toast API

Access Toast POS data via reliable API. Supergood creates and maintains production-ready APIs for Toast without traditional integration costs or engineering resources.

What is Toast?

Toast is a cloud-based restaurant management platform used by over 100,000 restaurants for point-of-sale, online ordering, payroll, and operations management. It’s one of the most widely adopted POS systems in the hospitality industry, particularly among fast-casual and full-service restaurants.

The Toast Integration Challenge

While Toast offers partner APIs, accessing real-time operational data presents significant hurdles:

• Limited API scope : Partner APIs don’t expose all operational data visible in the Toast dashboard
• Multi-factor authentication : Accessing management portals requires complex authentication flows
• Rate limiting concerns - High-frequency data access can trigger security measures
• Mobile app data - The richest operational data lives in Toast’s mobile applications, not web APIs

How Supergood Creates Toast APIs

Supergood reverse-engineers Toast's mobile APIs at the network level to create a production-ready REST API.

Our platform authenticates through Toast’s standard login flow, maintains active sessions with automatic token refresh, and continuously monitors the integration to adapt when Toast updates its mobile interface. This gives you access to the same real-time data that Toast’s own mobile apps use.

Use Cases

Loyalty Program Integration

Sync itemized order data from Toast into your loyalty platform in real-time. Match transactions by timestamp and amount, then pull full item-level details to award points based on specific menu items purchased.

Payment Reconciliation

Automate the matching of payment processor transactions with Toast order data. Pull all orders for a business day and reconcile against your payment gateway to identify discrepancies without manual CSV exports.

Multi-Location Analytics

Aggregate order data across restaurant portfolios for real-time dashboards. Access standardized order data from all Toast locations without requiring each restaurant to configure API access or share credentials.

Operational Automation

Trigger workflows based on Toast order events. Send orders to kitchen display systems, update inventory management platforms, or alert staff when high-value orders are placed—all without requiring engineering resources from the restaurant.

Available Endpoints

Authentication

POST /authenticate : Login with username, password and phone number. Supergood handles all MFA over email, phone or TOTP. Returns an auth token.

POST /reauthenticate : Refresh authentication token (50-minute expiry)

Check Data

GET /checks - Retrieves all checks for a business date (non-itemized summary)

GET /checks/{checkId} - Fetch complete itemized check details including menu items, modifiers, pricing, tax and tip breakdown.

Restaurant Management

GET /restaurants - List accessible restaurants and the associated metadata

GET /restaurants/{restaurantId}/sales - Fetch all sales for a given restaurant.

Technical Specifications

• Authentication : Use Supergood managed service accounts, or use your own. Username/Password + MFA verification via phone, email or TOTP code.
• Response Format: JSON
• Rate Limits: High throughput capable (1+ req/sec per restaurant)
• Token Expiry: 50 minutes with automatic refresh
• Data Freshness: Real-time data available as soon as orders are entered in Toast
• Multi-tenancy: One service account can access multiple restaurant locations
• Webhook Support: Requests can be made synchornously or asynchronously with a provided callback URL.

Performance Characteristics

• Latency : Sub-second response times for order queries
• Throughput : Production-tested at scale with continous polling
• Stealth : Uses Toast's native mobile API and managed service accounts for seamless authentication.

Getting Started

1. Schedule Integration Assessment

Book a 30-minute call to review your specific Toast data requirements and authentication approach.

2. Supergood Generates and Validates Your API

Supergood will generate a production-ready version of your API to make it available for authentication setup and testing.

3. Deploy with Monitoring

Launch to production with built-in monitoring and automatic adaptation to Toast platform changes.

Frequently Asked Questions

Q: What happens if Toast changes their mobile app?

Supergood continuously monitors the Toast integration and automatically adapts when Toast updates its mobile interface. You’ll receive notifications of any temporary disruptions.

Q: Can I use one account for multiple restaurants?

Yes. Initially, we recommend starting with a single service account that can access multiple locations. For production scale, we can provision one service account per restaurant for enhanced resilience.

Q: How do you handle authentication expiration?

Our platform automatically refreshes authentication tokens every 45 minutes (before the 50-minute expiry). This means little-to-no authentication latency on your API calls.

Ready to automate your Toast workflows?

Supergood can have your integration running in days with no ongoing engineering maintenance.