xtraCHEF API
xtraCHEF by Toast is an automated restaurant management platform for accounts payable automation, invoice processing, food cost intelligence, inventory, recipe management, and procurement. An unofficial API lets you programmatically pull invoices, vendors, inventory items, recipes, and food-cost reports—and push updates like approved invoices, purchase orders, and item mappings back into xtraCHEF.
What is xtraCHEF?
xtraCHEF (now xtraCHEF by Toast) is an automated restaurant management software platform that turns invoices and purchase data into food cost intelligence. Restaurants—from fine dining to quick service, multi-concept operators, and franchises—use xtraCHEF to automate accounts payable, capture ingredient-level invoice data, track food costs and COGS against budgets and forecasted sales, manage inventory and recipes, and run procurement, all without manual data entry.
Core product areas include:
- AP Automation (invoice capture, line-item extraction, approval workflows, accounting sync)
- Food Cost Management (food cost ratios, gross margin analysis, COGS against budgeted and forecasted sales)
- Inventory Management (item mapping, counts, par levels, vendor categories)
- Recipe Management (recipe and modifier costing, menu engineering, theoretical consumption)
- Procurement / Purchase Order Management and Price Tracker
- Budgets & Forecasting and Manufacturer Rebates
Common data entities:
- Invoices, Invoice Line Items, Vendors, Approvals
- Inventory Items, Counts, Par Levels, Item Mappings
- Recipes, Recipe Modifiers, Menu Items, Ingredient Costs
- Purchase Orders, Price Trackers, Rebates
- Food Cost Reports, Budgets, Forecasts, Locations/Units
The xtraCHEF Integration Challenge
Restaurant operators run AP, food cost, and inventory workflows in xtraCHEF every day, but turning that web- and mobile-driven data into API-driven automation is non-trivial:
- No public developer API: xtraCHEF exposes a web and mobile app for operators, not a documented, self-serve API for pulling invoices, inventory, and food-cost data programmatically
- Toast platform gating: As xtraCHEF by Toast, data flows through the Toast ecosystem, and external access depends on partnership and account-level entitlements
- OCR-driven invoice data: Line-item invoice extraction, verification, and approval are workflow states inside the app—exporting them cleanly per vendor and location takes careful handling
- Multi-unit spread: Franchises and multi-concept operators run many locations, each with its own vendors, item mappings, and budgets that must stay distinct
- Mobile-first access: Much of the day-to-day capture happens on mobile, complicating headless, server-to-server automation
- Recipe-to-sales mapping: Tying menu items and modifiers to recipes for theoretical consumption and par ordering is stateful and must reconcile against POS sales data
How Supergood Creates xtraCHEF APIs
Supergood reverse-engineers the authenticated xtraCHEF web and mobile flows to deliver a resilient API layer for your account—across AP, food cost, inventory, recipes, and procurement—without waiting on a public developer program.
- Handles username/password and MFA securely in a managed session
- Maintains session continuity with automated refresh and change detection
- Normalizes responses across invoices, inventory, recipes, and food-cost reports so you integrate once and rely on consistent objects
- Preserves per-location vendors, item mappings, and budgets across multi-unit accounts
Use xtraCHEF with AI agents: xtraCHEF MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, locations, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready xtraCHEF adapter tailored to your account configuration and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as xtraCHEF evolves.
API Endpoints
Authentication
/authenticateAuthenticate to an xtraCHEF account using username/password, or MFA, and obtain a session token for downstream calls.
Accounts Payable
/invoicesList captured invoices with line items, vendor, location, status, and approval state, filtered by date range and unit.
Accounts Payable
/approve_invoiceApprove or update an invoice and its extracted line items, advancing it through the AP workflow.
Inventory
/inventory_itemsRetrieve inventory items, counts, par levels, item mappings, and vendor categories across locations.
Food Cost
/food_cost_reportsPull food cost ratio, COGS, and gross margin reports against budgeted and forecasted sales by category and unit.
Procurement
/create_purchase_orderCreate a purchase order against a vendor with items, quantities, and pricing pulled from the Price Tracker.
Use Cases
Sync AP and invoice data into accounting
- Pull captured invoices and extracted line items per vendor and location - Push approval status and GL coding back into AP workflows - Reconcile invoice totals against accounting and ERP systems automatically
Automate food cost and margin reporting
- Stream food cost ratios, COGS, and gross margin reports into BI tools - Compare actual food cost against budgeted targets and forecasted sales - Surface menu items with margin erosion driven by vendor price changes
Keep inventory and recipes in sync
- Pull inventory items, counts, and par levels for replenishment systems - Map menu items and modifiers to recipes for theoretical consumption - Push item mappings and recipe costs back to keep units consistent
Automate procurement and price tracking
- Generate purchase orders from par levels and Price Tracker data - Monitor vendor price fluctuations and trigger reorder workflows - Track manufacturer rebates against purchase volume across locations
Technical Specifications
Authentication
Username/password and MFA handled in a managed session
Connectivity
Authenticated web and mobile app flows reverse-engineered into a stable API surface
Response format
Normalized JSON across invoices, inventory, recipes, and food-cost objects
Rate limits
Adaptive throttling tuned to your account to avoid platform-side limits
Session management
Automatic session refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time pulls for invoices, inventory, and food-cost reports with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for invoice capture, approval, price changes, and inventory updates
Latency
Sub-second reads on cached entities; multi-second writes when posting approvals and purchase orders
Throughput
Horizontally scaled workers sized to multi-location invoice and inventory volume
Reliability
Retry, backoff, and idempotency keys for invoice approvals and purchase-order writes
Adaptation
Continuous monitoring of xtraCHEF and Toast platform changes and account configuration drift
Frequently asked questions
xtraCHEF does not publish a self-serve developer API for pulling invoices, inventory, and food-cost data. Supergood builds a resilient API layer on top of your authenticated xtraCHEF account so you can integrate programmatically without a public API program.
Yes. Supergood surfaces captured invoices with their extracted line items, vendor, location, and approval state, normalized into consistent JSON so you can sync AP data into accounting and BI tools.
Yes. The API preserves per-location vendors, item mappings, budgets, and food-cost reports, so franchises and multi-concept operators can integrate every unit while keeping data distinct.
No. Supergood works with your existing xtraCHEF and Toast account entitlements and authenticated sessions rather than depending on a separate partner API program.
Yes. Food cost ratios, COGS, and gross margin reports against budgeted and forecasted sales are exposed through the same normalized API surface, by category and unit.