grubhub
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.
Real signal across most facets with visible, nameable gaps — the contract exists but is thin, or the portal is good while governance and commercial terms are absent.
API Evangelist profiles grubhub the way a machine reads it — 199 machine-readable artifacts across 17 APIs, pulled from the provider's own public surface and indexed so a developer, an analyst, or an AI agent can evaluate it against every other provider on the network.
Every provider in the network is reduced to the same set of machine-readable artifacts — OpenAPI contracts, event specifications, GraphQL schemas, runnable collections, pricing and rate-limit signals, security posture, OAuth scopes, and the agent surfaces (MCP servers and skills) that let software drive the API on its own. We profile them because the interface is the part of a company you can actually inspect: it is a truer signal of what a provider does than any marketing page. From those artifacts we compute the Kin Score — grubhub scores 50.9/100 (developing), with a separate agent-readiness read of 54/100 (agent ready). The full breakdown is below, followed by every artifact we hold — each card links through to its machine-readable definition on apis.io.
Kin Score
This is the API Evangelist rating — a single, repeatable read computed from the artifacts on this page. Green fill is points earned; the red track is points possible, so every bar shows earned-versus-possible at a glance.
Kin Score
How this is scored →scored 2026-07-27 · rubric v0.5
How we profile grubhub
Each block below is one kind of artifact we hold for grubhub. For each we say what it is and why it earns a place in the profile, then list every one we've indexed — capped at two rows, scroll within the panel for the rest.
APIs 17
Each API is captured as its own OpenAPI definition — every operation, parameter, and response. This is the single most useful machine-readable description of what an API does, and it's what lets us score, lint, mock, and generate against it without asking the provider for anything.
Individual APIs this provider publishes, each with its own machine-readable definition.
grubhub Delivery Status API
Endpoints for tracking delivery status, driver information, and estimated arrival times.
grubhub Driver Communication API
Endpoints for establishing communication with delivery drivers through proxy phone numbers.
grubhub Issue Reporting API
Endpoints for reporting onboarding issues to Grubhub.
grubhub Menu Ingestion API
Endpoints for uploading and managing normalized menus including schedules, sections, items, and modifiers.
grubhub Menu Retrieval API
Endpoints for retrieving the current menu for a merchant.
grubhub Menu Schedule Overrides API
Endpoints for managing menu schedule overrides such as temporary availability changes.
grubhub Merchant Eligibility API
Endpoints for checking merchant eligibility for onboarding.
grubhub Merchant Onboarding API
Endpoints for onboarding merchants to the Grubhub platform, including referrals, activation, and association.
grubhub Merchant Properties API
Endpoints for updating merchant properties such as fulfillment settings and tax rates.
grubhub Merchant Status API
Endpoints for managing merchant online/offline status on Grubhub, including soft and hard pauses.
grubhub Merchants API
Endpoints for retrieving merchant information and ID mappings.
grubhub Order Change Requests API
Endpoints for managing order change requests and modifications.
grubhub Order Polling API
Endpoints for polling orders across multiple merchants. Webhook subscription is the preferred method for receiving new orders.
grubhub Order Status API
Endpoints for confirming orders and updating order lifecycle states.
grubhub Orders API
Endpoints for retrieving and managing orders placed through the Grubhub Marketplace.
grubhub Schedule Overrides API
Endpoints for creating and managing temporary schedule overrides such as closures and holiday hours.
grubhub Schedules API
Endpoints for retrieving and managing merchant operating hours for delivery, pickup, and catering.
Scroll within the panel for all 17 ·
Open Collections 6
Open, tool-agnostic collections carry the same runnable value as Postman without locking you to one client — the portable, forkable form of the same exercise.
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
Grubhub Deliveries API
OPEN COLLECTIONGrubhub Menu API
OPEN COLLECTIONGrubhub Merchant Data API
OPEN COLLECTIONGrubhub Merchant Schedules API
OPEN COLLECTIONGrubhub Onboarding API
OPEN COLLECTIONGrubhub Orders API
OPEN COLLECTIONGraphQL 1
Where a provider ships GraphQL, the schema is the contract. We profile it alongside the REST surface so the whole interface is legible in one place.
GraphQL schemas published by this provider.
Grubhub GraphQL Schema
This document describes a conceptual GraphQL schema for the Grubhub food delivery marketplace platform. Grubhub provides REST APIs for partners and merchants to manage menus, or...
GRAPHQLPricing Plans 1
Pricing is part of the interface. Machine-readable plans tell you what a tier costs and includes before you commit — one of the six things the Kin Score reads for commercial clarity.
Published pricing tiers and plan structures.
Rate Limits 1
Rate limits are the difference between a demo that works and a production integration that doesn't fall over. Publishing them is an operational-transparency signal — and a hard requirement for any agent that plans its own throughput.
Documented rate limits and quota policies.
Grubhub Rate Limits
RATE LIMITSFinOps 1
Cost, billing, and metering signals let a buyer model the financial operations of an API before it's live. We profile them for the same reason we profile pricing: the money is part of the contract.
Cost, billing, and metering signals for API financial operations.
Grubhub Finops
FINOPSEvent Specifications 2
Not every API is request/response. AsyncAPI describes the event-driven and streaming side — the webhooks and channels — so the asynchronous half of the interface is documented the same way the synchronous half is.
AsyncAPI definitions for this provider's event-driven and streaming APIs.
Grubhub Delivery Events
Event-driven interface for receiving real-time delivery status updates from Grubhub. Partners can subscribe to webhook notifications for delivery updates including driver assign...
ASYNCAPIGrubhub Order Events
Event-driven interface for receiving real-time order notifications from Grubhub. When a diner places an order, Grubhub monitors that order and sends notifications based on the c...
ASYNCAPISemantic Vocabularies 1
JSON-LD contexts give the data shared meaning across APIs. We profile them because semantics are what let a machine reconcile 'customer' here with 'customer' somewhere else.
JSON-LD contexts and semantic vocabularies used across these APIs.
Grubhub Context
JSON-LDSpectral Rules 3
Governance rulesets we run against this provider's specs — the automated checks behind parts of the score. Profiling them makes the quality bar explicit and re-runnable, not a matter of opinion.
JSON Schema 54
Standalone JSON Schema definitions describe the data models behind the API. We profile them so the shapes are validatable on their own — useful long after a single request is forgotten.
Standalone JSON Schema definitions for this provider's data models.
Address
JSON SCHEMAAvailability
JSON SCHEMABatchJobResponse
JSON SCHEMABatchJobStatus
JSON SCHEMAContact
JSON SCHEMAGrubhub Courier Location Payload
JSON SCHEMACustomer
JSON SCHEMADaySchedule
JSON SCHEMADelivery
JSON SCHEMAGrubhub Delivery Cancelled Payload
JSON SCHEMAGrubhub Delivery Refund Payload
JSON SCHEMAGrubhub Delivery Status Payload
JSON SCHEMADriver
JSON SCHEMAGrubhub Driver Assigned Payload
JSON SCHEMAEligibilityResponse
JSON SCHEMAError
JSON SCHEMAFulfillmentInfo
JSON SCHEMAIngestionJobResponse
JSON SCHEMAIngestionJobStatus
JSON SCHEMAGrubhub Normalized Menu
JSON SCHEMAMenuItem
JSON SCHEMAMenuSchedule
JSON SCHEMAMenuScheduleOverrideRequest
JSON SCHEMAMenuSection
JSON SCHEMAGrubhub Merchant
JSON SCHEMAMerchantActivationRequest
JSON SCHEMAMerchantAssociationRequest
JSON SCHEMAMerchantDeactivationRequest
JSON SCHEMAMerchantMapping
JSON SCHEMAMerchantPropertiesUpdateRequest
JSON SCHEMAMerchantReferral
JSON SCHEMAMerchantStatusUpdateRequest
JSON SCHEMAModifierOption
JSON SCHEMAModifierPrompt
JSON SCHEMAOnboardingIssue
JSON SCHEMAGrubhub Order
JSON SCHEMAGrubhub Order Cancellation Payload
JSON SCHEMAOrderChangeRequest
JSON SCHEMAGrubhub Order Change Request Payload
JSON SCHEMAOrderConfirmation
JSON SCHEMAOrderItem
JSON SCHEMAOrderStatusUpdate
JSON SCHEMAGrubhub Order Status Webhook Payload
JSON SCHEMAOrderTotals
JSON SCHEMAGrubhub Order Webhook Payload
JSON SCHEMAPosNormalizedMenu
JSON SCHEMAProxyPhone
JSON SCHEMAReferralResponse
JSON SCHEMAScheduleOverride
JSON SCHEMAScheduleOverrideRequest
JSON SCHEMASizeOption
JSON SCHEMASizePrompt
JSON SCHEMATimeWindow
JSON SCHEMAWeeklySchedule
JSON SCHEMAScroll within the panel for all 54 ·
JSON Structure 54
JSON Structure captures the data shapes in a form built for tooling — a complement to JSON Schema that keeps the model machine-legible.
JSON Structure definitions describing this provider's data shapes.
Grubhub Address Structure
JSON STRUCTUREGrubhub Availability Structure
JSON STRUCTUREGrubhub Batchjobresponse Structure
JSON STRUCTUREGrubhub Batchjobstatus Structure
JSON STRUCTUREGrubhub Contact Structure
JSON STRUCTUREGrubhub Courierlocationpayload Structure
JSON STRUCTUREGrubhub Customer Structure
JSON STRUCTUREGrubhub Dayschedule Structure
JSON STRUCTUREGrubhub Delivery Structure
JSON STRUCTUREGrubhub Deliverycancelledpayload Structure
JSON STRUCTUREGrubhub Deliveryrefundpayload Structure
JSON STRUCTUREGrubhub Deliverystatuspayload Structure
JSON STRUCTUREGrubhub Driver Structure
JSON STRUCTUREGrubhub Driverassignedpayload Structure
JSON STRUCTUREGrubhub Eligibilityresponse Structure
JSON STRUCTUREGrubhub Error Structure
JSON STRUCTUREGrubhub Fulfillmentinfo Structure
JSON STRUCTUREGrubhub Ingestionjobresponse Structure
JSON STRUCTUREGrubhub Ingestionjobstatus Structure
JSON STRUCTUREGrubhub Menu Structure
JSON STRUCTUREGrubhub Menuitem Structure
JSON STRUCTUREGrubhub Menuschedule Structure
JSON STRUCTUREGrubhub Menuscheduleoverriderequest Structure
JSON STRUCTUREGrubhub Menusection Structure
JSON STRUCTUREGrubhub Merchant Structure
JSON STRUCTUREGrubhub Merchantactivationrequest Structure
JSON STRUCTUREGrubhub Merchantassociationrequest Structure
JSON STRUCTUREGrubhub Merchantdeactivationrequest Structure
JSON STRUCTUREGrubhub Merchantmapping Structure
JSON STRUCTUREGrubhub Merchantpropertiesupdaterequest Structure
JSON STRUCTUREGrubhub Merchantreferral Structure
JSON STRUCTUREGrubhub Merchantstatusupdaterequest Structure
JSON STRUCTUREGrubhub Modifieroption Structure
JSON STRUCTUREGrubhub Modifierprompt Structure
JSON STRUCTUREGrubhub Onboardingissue Structure
JSON STRUCTUREGrubhub Order Structure
JSON STRUCTUREGrubhub Ordercancellationpayload Structure
JSON STRUCTUREGrubhub Orderchangerequest Structure
JSON STRUCTUREGrubhub Orderchangerequestpayload Structure
JSON STRUCTUREGrubhub Orderconfirmation Structure
JSON STRUCTUREGrubhub Orderitem Structure
JSON STRUCTUREGrubhub Orderstatusupdate Structure
JSON STRUCTUREGrubhub Orderstatuswebhookpayload Structure
JSON STRUCTUREGrubhub Ordertotals Structure
JSON STRUCTUREGrubhub Orderwebhookpayload Structure
JSON STRUCTUREGrubhub Posnormalizedmenu Structure
JSON STRUCTUREGrubhub Proxyphone Structure
JSON STRUCTUREGrubhub Referralresponse Structure
JSON STRUCTUREGrubhub Scheduleoverride Structure
JSON STRUCTUREGrubhub Scheduleoverriderequest Structure
JSON STRUCTUREGrubhub Sizeoption Structure
JSON STRUCTUREGrubhub Sizeprompt Structure
JSON STRUCTUREGrubhub Timewindow Structure
JSON STRUCTUREGrubhub Weeklyschedule Structure
JSON STRUCTUREScroll within the panel for all 54 ·
Examples 54
Real request and response payloads are what turn a spec from abstract into obvious — and they're one of the twelve things an agent needs to call an API correctly on the first try.
Example request and response payloads for these APIs.
Grubhub Address Example
EXAMPLEGrubhub Availability Example
EXAMPLEGrubhub Contact Example
EXAMPLEGrubhub Customer Example
EXAMPLEGrubhub Dayschedule Example
EXAMPLEGrubhub Delivery Example
EXAMPLEGrubhub Driver Example
EXAMPLEGrubhub Error Example
EXAMPLEGrubhub Menu Example
EXAMPLEGrubhub Menuitem Example
EXAMPLEGrubhub Menuschedule Example
EXAMPLEGrubhub Menusection Example
EXAMPLEGrubhub Merchant Example
EXAMPLEGrubhub Order Example
EXAMPLEGrubhub Orderitem Example
EXAMPLEGrubhub Ordertotals Example
EXAMPLEGrubhub Proxyphone Example
EXAMPLEGrubhub Sizeoption Example
EXAMPLEGrubhub Sizeprompt Example
EXAMPLEGrubhub Timewindow Example
EXAMPLEScroll within the panel for all 54 ·
Security Posture 2
Authentication, domain security, vulnerability disclosure, and trust-center signals — the evidence that a provider takes security seriously enough to document it. We profile it because you can't govern what you can't see.
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Scopes 1
OAuth scopes are the vocabulary of least-privilege access. Profiling them shows exactly what an integration — or an agent acting on a user's behalf — is allowed to do.
OAuth scopes governing access to this provider's APIs.
Agentic Access 1
An x-agentic-access contract marks which operations are safe for an agent to run on its own and which need a human in the loop. It is the difference between an API an agent can use and one it can use safely.
Recommended x-agentic-access execution contracts for AI agents.
Resources
Every other property we hold for grubhub — documentation, portals, status pages, policies, and corporate surface — grouped by the job it does, following the integrator's arc from getting started to running in production.
Documentation 3
Reference material describing how the API behaves
Agent Surfaces 1
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 3
Pagination, idempotency, versioning, errors, and events
Build 1
SDKs, sample code, and the tooling you integrate with
Access & Security 3
Authentication, authorization, and security posture
Operate 1
Status, limits, changes, and where to get help
Commercial 2
Pricing, plans, and the legal terms of use
Company 2
The organization behind the API
← All providers · Data indexed from github.com/api-evangelist/grubhub · machine-readable index on apis.io