Grubhub works with brands, point of sale companies, and online ordering providers to power an ordering experience in Grubhub Marketplace and within restaurant-branded web experiences. This documentation describes the normalized endpoints required for ingesting menu content and facilitating order transmission.
URL: Visit APIs.json URL
Run: Capabilities Using Naftiko
- Food Delivery, Online Ordering, Restaurants, Marketplaces, Merchants, Logistics
- Modified: 2026-05-19
The Grubhub Menu API enables partners and merchants to create, update, and manage restaurant menus within the Grubhub Marketplace. It supports building normalized menu structures including categories, items, modifiers, and pricing. POS integrations are required to sync menus through this API, ensuring that restaurant offerings on Grubhub stay current with their local menu changes.
Human URL: https://developer.grubhub.com/api/menu
- Food Delivery, Menus, Online Ordering, Restaurants
The Grubhub Orders API allows partners to receive, manage, and update order statuses for restaurant orders placed through the Grubhub Marketplace. When a customer places an order, Grubhub sends it to the partner's endpoint via webhook subscription. Partners can confirm orders, update preparation status, mark orders as ready for pickup, and track delivery progress through defined order lifecycle states.
Human URL: https://developer.grubhub.com/api/orders
- Food Delivery, Online Ordering, Orders, Restaurants, Webhooks
- Documentation
- OpenAPI
- AsyncAPI
- NaftikoCapability
- NaftikoCapability
- NaftikoCapability
- NaftikoCapability
The Grubhub Merchant Data API provides endpoints for managing merchant information, including store details, tax rates, fulfillment settings, and configuration groups. Partners can retrieve all Grubhub locations associated with a merchant's account, update merchant profiles, and manage operational settings. This API is essential for maintaining accurate restaurant data across the Grubhub platform.
Human URL: https://developer.grubhub.com/api/merchant-data
- Data Management, Food Delivery, Merchants, Restaurants
The Grubhub Merchant Schedules API allows partners to manage restaurant operating hours and availability on the Grubhub Marketplace. It supports setting regular business hours, temporary closures, and special holiday schedules. Partners can check merchant availability status and update schedules to ensure customers see accurate ordering windows for each restaurant location.
Human URL: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
- Availability, Food Delivery, Restaurants, Scheduling
The Grubhub Deliveries API enables partners to manage delivery logistics and interact with Grubhub's nationwide courier network. It provides delivery status tracking through key states including driver assignment, pickup ready, and out for delivery. Partners can leverage Grubhub Connect, a full-service delivery solution for delivery aggregators, marketplaces, and enterprise merchants to fulfill orders using Grubhub drivers.
Human URL: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
- Delivery Tracking, Drivers, Food Delivery, Logistics
The Grubhub Onboarding API enables partners to offer self-service integration onboarding directly to their merchants using OAuth-based authentication. It provides endpoints for new merchant referrals, merchant activation and deactivation, merchant association, and reporting onboarding issues. The API can reduce merchant onboarding time from 7-10 days down to as little as 5-10 minutes, significantly decreasing integration downtime.
Human URL: https://developer.grubhub.com/api/onboarding
- Food Delivery, Integration, Merchants, Onboarding
- GitHubOrganization
- JSONLD
- JSONSchema
- JSONSchema
- JSONSchema
- Vocabulary
- Rules
- Plans
- RateLimits
- FinOps
Machine-readable API specifications and supporting artifacts organized by format.
- Deliveries OpenAPI
- Menu OpenAPI
- Merchant Data OpenAPI
- Merchant Schedules OpenAPI
- Onboarding OpenAPI
- Orders OpenAPI
54 JSON Schema files in json-schema/.
54 JSON Structure files in json-structure/.
54 Examples files in examples/.
Self-contained Naftiko capabilities, one per API business surface, each exposing both a REST and an MCP adapter.
| Capability | API | Tools |
|---|---|---|
| Grubhub Deliveries API — Delivery Status | Deliveries | 1 |
| Grubhub Deliveries API — Driver Communication | Deliveries | 1 |
| Grubhub Menu API — Menu Ingestion | Menu | 2 |
| Grubhub Menu API — Menu Retrieval | Menu | 1 |
| Grubhub Menu API — Menu Schedule Overrides | Menu | 2 |
| Grubhub Merchant Data API — Merchant Properties | Merchant Data | 3 |
| Grubhub Merchant Data API — Merchant Status | Merchant Data | 2 |
| Grubhub Merchant Data API — Merchants | Merchant Data | 2 |
| Grubhub Merchant Schedules API — Schedule Overrides | Merchant Schedules | 2 |
| Grubhub Merchant Schedules API — Schedules | Merchant Schedules | 6 |
| Grubhub Onboarding API — Issue Reporting | Onboarding | 1 |
| Grubhub Onboarding API — Merchant Eligibility | Onboarding | 1 |
| Grubhub Onboarding API — Merchant Onboarding | Onboarding | 5 |
| Grubhub Orders API — Order Change Requests | Orders | 1 |
| Grubhub Orders API — Order Polling | Orders | 1 |
| Grubhub Orders API — Order Status | Orders | 2 |
| Grubhub Orders API — Orders | Orders | 2 |
- Grubhub Vocabulary — Unified taxonomy mapping 17 resources, 12 actions, 17 workflows, and 3 personas across operational (OpenAPI) and capability (Naftiko) dimensions
- Grubhub Spectral Rules — 44 rules enforcing Grubhub API conventions (paths, naming, security, responses, examples)
- Plans & Pricing — API Commons Plans: partner integration plus tiered Marketplace commission plans
- Rate Limits — API Commons Rate Limits: ~200-400 requests/minute per source, 429 on exceed
- FinOps — FOCUS-aligned FinOps: tiered take-rate commercial model
FN: Kin Lane
Email: kin@apievangelist.com