grubhub website screenshot

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.

grubhub publishes 17 APIs on the APIs.io network, including Delivery Status API, Driver Communication API, Issue Reporting API, and 14 more.

The grubhub catalog on APIs.io includes 2 event-driven AsyncAPI specifications, 1 JSON-LD context, and 3 Spectral governance rulesets.

grubhub’s developer surface includes authentication, engineering blog, and 14 more developer resources.

🌐 Visit website 📡 Source on GitHub
48.1/100 developing ▬ flat Agent 50/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessPaidSelf serve
17 APIs

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 48.1/100 · developing
Contract Quality 20.6 / 25
Developer Ergonomics 2.6 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 4.8 / 13
Governance 6.3 / 12
Discoverability 5.9 / 10
Agent readiness — 50/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/grubhub: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 17

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 for all 17

Open Collections 6

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Grubhub Deliveries API

OPEN COLLECTION

Grubhub Menu API

OPEN COLLECTION

Grubhub Merchant Data API

OPEN COLLECTION

Grubhub Merchant Schedules API

OPEN COLLECTION

Grubhub Onboarding API

OPEN COLLECTION

Grubhub Orders API

OPEN COLLECTION

GraphQL 1

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...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Grubhub Plans Pricing

4 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Grubhub Rate Limits

3 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Grubhub Finops

FINOPS

Event Specifications 2

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...

ASYNCAPI

Grubhub 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...

ASYNCAPI

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Grubhub Context

0 classes · 7 properties

JSON-LD

Spectral Rules 3

Spectral governance rulesets for linting and validating these APIs.

grubhub API Rules

9 rules · 1 errors 8 warnings

SPECTRAL

grubhub API Rules

6 rules · 5 warnings 1 info

SPECTRAL

grubhub API Rules

51 rules · 8 errors 29 warnings 14 info

SPECTRAL

JSON Schema 54

Standalone JSON Schema definitions for this provider's data models.

Address

6 properties

JSON SCHEMA

Availability

3 properties

JSON SCHEMA

BatchJobResponse

1 properties

JSON SCHEMA

BatchJobStatus

3 properties

JSON SCHEMA

Contact

3 properties

JSON SCHEMA

Grubhub Courier Location Payload

8 properties

JSON SCHEMA

Customer

3 properties

JSON SCHEMA

DaySchedule

2 properties

JSON SCHEMA

Delivery

7 properties

JSON SCHEMA

Grubhub Delivery Cancelled Payload

5 properties

JSON SCHEMA

Grubhub Delivery Refund Payload

7 properties

JSON SCHEMA

Grubhub Delivery Status Payload

7 properties

JSON SCHEMA

Driver

5 properties

JSON SCHEMA

Grubhub Driver Assigned Payload

7 properties

JSON SCHEMA

EligibilityResponse

3 properties

JSON SCHEMA

Error

3 properties

JSON SCHEMA

FulfillmentInfo

6 properties

JSON SCHEMA

IngestionJobResponse

1 properties

JSON SCHEMA

IngestionJobStatus

3 properties

JSON SCHEMA

Grubhub Normalized Menu

2 properties

JSON SCHEMA

MenuItem

7 properties

JSON SCHEMA

MenuSchedule

4 properties

JSON SCHEMA

MenuScheduleOverrideRequest

1 properties

JSON SCHEMA

MenuSection

3 properties

JSON SCHEMA

Grubhub Merchant

11 properties

JSON SCHEMA

MerchantActivationRequest

1 properties

JSON SCHEMA

MerchantAssociationRequest

1 properties

JSON SCHEMA

MerchantDeactivationRequest

2 properties

JSON SCHEMA

MerchantMapping

4 properties

JSON SCHEMA

MerchantPropertiesUpdateRequest

1 properties

JSON SCHEMA

MerchantReferral

5 properties

JSON SCHEMA

MerchantStatusUpdateRequest

1 properties

JSON SCHEMA

ModifierOption

4 properties

JSON SCHEMA

ModifierPrompt

6 properties

JSON SCHEMA

OnboardingIssue

3 properties

JSON SCHEMA

Grubhub Order

14 properties

JSON SCHEMA

Grubhub Order Cancellation Payload

6 properties

JSON SCHEMA

OrderChangeRequest

5 properties

JSON SCHEMA

Grubhub Order Change Request Payload

7 properties

JSON SCHEMA

OrderConfirmation

1 properties

JSON SCHEMA

OrderItem

6 properties

JSON SCHEMA

OrderStatusUpdate

2 properties

JSON SCHEMA

Grubhub Order Status Webhook Payload

6 properties

JSON SCHEMA

OrderTotals

5 properties

JSON SCHEMA

Grubhub Order Webhook Payload

10 properties

JSON SCHEMA

PosNormalizedMenu

2 properties

JSON SCHEMA

ProxyPhone

2 properties

JSON SCHEMA

ReferralResponse

3 properties

JSON SCHEMA

ScheduleOverride

6 properties

JSON SCHEMA

ScheduleOverrideRequest

5 properties

JSON SCHEMA

SizeOption

3 properties

JSON SCHEMA

SizePrompt

3 properties

JSON SCHEMA

TimeWindow

2 properties

JSON SCHEMA

WeeklySchedule

7 properties

JSON SCHEMA

Scroll for all 54

JSON Structure 54

JSON Structure definitions describing this provider's data shapes.

Grubhub Address Structure

6 properties

JSON STRUCTURE

Grubhub Availability Structure

3 properties

JSON STRUCTURE

Grubhub Batchjobresponse Structure

1 properties

JSON STRUCTURE

Grubhub Batchjobstatus Structure

3 properties

JSON STRUCTURE

Grubhub Contact Structure

3 properties

JSON STRUCTURE

Grubhub Courierlocationpayload Structure

8 properties

JSON STRUCTURE

Grubhub Customer Structure

3 properties

JSON STRUCTURE

Grubhub Dayschedule Structure

2 properties

JSON STRUCTURE

Grubhub Delivery Structure

7 properties

JSON STRUCTURE

Grubhub Deliverycancelledpayload Structure

5 properties

JSON STRUCTURE

Grubhub Deliveryrefundpayload Structure

7 properties

JSON STRUCTURE

Grubhub Deliverystatuspayload Structure

7 properties

JSON STRUCTURE

Grubhub Driver Structure

5 properties

JSON STRUCTURE

Grubhub Driverassignedpayload Structure

7 properties

JSON STRUCTURE

Grubhub Eligibilityresponse Structure

3 properties

JSON STRUCTURE

Grubhub Error Structure

3 properties

JSON STRUCTURE

Grubhub Fulfillmentinfo Structure

6 properties

JSON STRUCTURE

Grubhub Ingestionjobresponse Structure

1 properties

JSON STRUCTURE

Grubhub Ingestionjobstatus Structure

3 properties

JSON STRUCTURE

Grubhub Menu Structure

2 properties

JSON STRUCTURE

Grubhub Menuitem Structure

7 properties

JSON STRUCTURE

Grubhub Menuschedule Structure

4 properties

JSON STRUCTURE

Grubhub Menuscheduleoverriderequest Structure

1 properties

JSON STRUCTURE

Grubhub Menusection Structure

3 properties

JSON STRUCTURE

Grubhub Merchant Structure

11 properties

JSON STRUCTURE

Grubhub Merchantactivationrequest Structure

1 properties

JSON STRUCTURE

Grubhub Merchantassociationrequest Structure

1 properties

JSON STRUCTURE

Grubhub Merchantdeactivationrequest Structure

2 properties

JSON STRUCTURE

Grubhub Merchantmapping Structure

4 properties

JSON STRUCTURE

Grubhub Merchantpropertiesupdaterequest Structure

1 properties

JSON STRUCTURE

Grubhub Merchantreferral Structure

5 properties

JSON STRUCTURE

Grubhub Merchantstatusupdaterequest Structure

1 properties

JSON STRUCTURE

Grubhub Modifieroption Structure

4 properties

JSON STRUCTURE

Grubhub Modifierprompt Structure

6 properties

JSON STRUCTURE

Grubhub Onboardingissue Structure

3 properties

JSON STRUCTURE

Grubhub Order Structure

14 properties

JSON STRUCTURE

Grubhub Ordercancellationpayload Structure

6 properties

JSON STRUCTURE

Grubhub Orderchangerequest Structure

5 properties

JSON STRUCTURE

Grubhub Orderchangerequestpayload Structure

7 properties

JSON STRUCTURE

Grubhub Orderconfirmation Structure

1 properties

JSON STRUCTURE

Grubhub Orderitem Structure

6 properties

JSON STRUCTURE

Grubhub Orderstatusupdate Structure

2 properties

JSON STRUCTURE

Grubhub Orderstatuswebhookpayload Structure

6 properties

JSON STRUCTURE

Grubhub Ordertotals Structure

5 properties

JSON STRUCTURE

Grubhub Orderwebhookpayload Structure

10 properties

JSON STRUCTURE

Grubhub Posnormalizedmenu Structure

2 properties

JSON STRUCTURE

Grubhub Proxyphone Structure

2 properties

JSON STRUCTURE

Grubhub Referralresponse Structure

3 properties

JSON STRUCTURE

Grubhub Scheduleoverride Structure

6 properties

JSON STRUCTURE

Grubhub Scheduleoverriderequest Structure

5 properties

JSON STRUCTURE

Grubhub Sizeoption Structure

3 properties

JSON STRUCTURE

Grubhub Sizeprompt Structure

3 properties

JSON STRUCTURE

Grubhub Timewindow Structure

2 properties

JSON STRUCTURE

Grubhub Weeklyschedule Structure

7 properties

JSON STRUCTURE

Scroll for all 54

Examples 54

Example request and response payloads for these APIs.

Grubhub Address Example

6 fields

EXAMPLE

Grubhub Availability Example

3 fields

EXAMPLE

Grubhub Batchjobresponse Example

1 fields

EXAMPLE

Grubhub Batchjobstatus Example

3 fields

EXAMPLE

Grubhub Contact Example

3 fields

EXAMPLE

Grubhub Courierlocationpayload Example

8 fields

EXAMPLE

Grubhub Customer Example

3 fields

EXAMPLE

Grubhub Dayschedule Example

2 fields

EXAMPLE

Grubhub Delivery Example

7 fields

EXAMPLE

Grubhub Deliverycancelledpayload Example

5 fields

EXAMPLE

Grubhub Deliveryrefundpayload Example

7 fields

EXAMPLE

Grubhub Deliverystatuspayload Example

7 fields

EXAMPLE

Grubhub Driver Example

5 fields

EXAMPLE

Grubhub Driverassignedpayload Example

7 fields

EXAMPLE

Grubhub Eligibilityresponse Example

3 fields

EXAMPLE

Grubhub Error Example

3 fields

EXAMPLE

Grubhub Fulfillmentinfo Example

6 fields

EXAMPLE

Grubhub Ingestionjobresponse Example

1 fields

EXAMPLE

Grubhub Ingestionjobstatus Example

3 fields

EXAMPLE

Grubhub Menu Example

2 fields

EXAMPLE

Grubhub Menuitem Example

7 fields

EXAMPLE

Grubhub Menuschedule Example

4 fields

EXAMPLE

Grubhub Menuscheduleoverriderequest Example

1 fields

EXAMPLE

Grubhub Menusection Example

3 fields

EXAMPLE

Grubhub Merchant Example

11 fields

EXAMPLE

Grubhub Merchantactivationrequest Example

1 fields

EXAMPLE

Grubhub Merchantassociationrequest Example

1 fields

EXAMPLE

Grubhub Merchantdeactivationrequest Example

2 fields

EXAMPLE

Grubhub Merchantmapping Example

4 fields

EXAMPLE

Grubhub Merchantpropertiesupdaterequest Example

1 fields

EXAMPLE

Grubhub Merchantreferral Example

5 fields

EXAMPLE

Grubhub Merchantstatusupdaterequest Example

1 fields

EXAMPLE

Grubhub Modifieroption Example

4 fields

EXAMPLE

Grubhub Modifierprompt Example

6 fields

EXAMPLE

Grubhub Onboardingissue Example

3 fields

EXAMPLE

Grubhub Order Example

14 fields

EXAMPLE

Grubhub Ordercancellationpayload Example

6 fields

EXAMPLE

Grubhub Orderchangerequest Example

5 fields

EXAMPLE

Grubhub Orderchangerequestpayload Example

7 fields

EXAMPLE

Grubhub Orderconfirmation Example

1 fields

EXAMPLE

Grubhub Orderitem Example

6 fields

EXAMPLE

Grubhub Orderstatusupdate Example

2 fields

EXAMPLE

Grubhub Orderstatuswebhookpayload Example

6 fields

EXAMPLE

Grubhub Ordertotals Example

5 fields

EXAMPLE

Grubhub Orderwebhookpayload Example

10 fields

EXAMPLE

Grubhub Posnormalizedmenu Example

2 fields

EXAMPLE

Grubhub Proxyphone Example

2 fields

EXAMPLE

Grubhub Referralresponse Example

3 fields

EXAMPLE

Grubhub Scheduleoverride Example

6 fields

EXAMPLE

Grubhub Scheduleoverriderequest Example

5 fields

EXAMPLE

Grubhub Sizeoption Example

3 fields

EXAMPLE

Grubhub Sizeprompt Example

3 fields

EXAMPLE

Grubhub Timewindow Example

2 fields

EXAMPLE

Grubhub Weeklyschedule Example

7 fields

EXAMPLE

Scroll for all 54

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Grubhub Authentication

apiKey/oauth2 · 2 schemes

SECURITY

Grubhub Domain Security

TLSv1.3 · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Grubhub Scopes

2 scopes · clientCredentials

2 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Grubhub Agentic Access

35 operations · 18 acting · 3 human-in-the-loop

35 operations · 18 acting

AGENTIC

Resources

Documentation 3

Reference material describing how the API behaves

JSONSchema
JSONSchema
 JSONSchema
JSONSchema
 JSONSchema
JSONSchema

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

JSONLD
JSONLD
 Vocabulary
Vocabulary
 Rules
Rules

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization

Access & Security 3

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication
 OAuthScopes
OAuthScopes

Operate 1

Status, limits, changes, and where to get help

RateLimits
RateLimits

Commercial 2

Pricing, plans, and the legal terms of use

Plans
Plans
 FinOps
FinOps

Company 2

The organization behind the API

LinkedIn
LinkedIn
 Blog
Blog

Source (apis.yml)

apis.yml Raw ↑ 
aid: grubhub
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Paid · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/grubhub.png
url: https://raw.githubusercontent.com/api-evangelist/grubhub/refs/heads/main/apis.yml
modified: '2026-05-19'
apis:
- aid: grubhub:grubhub-delivery-status-api
  name: grubhub Delivery Status API
  description: Endpoints for tracking delivery status, driver information, and estimated arrival times.
  humanURL: https://developer.grubhub.com/api/menu
  baseURL: https://api.grubhub.com
  tags:
  - Delivery Status
  properties:
  - type: OpenAPI
    url: openapi/grubhub-delivery-status-api-openapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/menu
  - type: GraphQL
    url: graphql/grubhub-graphql.md
  - type: Documentation
    url: https://developer.grubhub.com/api/orders
  - type: AsyncAPI
    url: asyncapi/grubhub-order-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/merchant-data
  - type: Documentation
    url: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
  - type: Documentation
    url: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
  - type: AsyncAPI
    url: asyncapi/grubhub-delivery-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/onboarding
- aid: grubhub:grubhub-driver-communication-api
  name: grubhub Driver Communication API
  description: Endpoints for establishing communication with delivery drivers through proxy phone numbers.
  humanURL: https://developer.grubhub.com/api/menu
  baseURL: https://api.grubhub.com
  tags:
  - Driver Communication
  properties:
  - type: OpenAPI
    url: openapi/grubhub-driver-communication-api-openapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/menu
  - type: GraphQL
    url: graphql/grubhub-graphql.md
  - type: Documentation
    url: https://developer.grubhub.com/api/orders
  - type: AsyncAPI
    url: asyncapi/grubhub-order-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/merchant-data
  - type: Documentation
    url: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
  - type: Documentation
    url: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
  - type: AsyncAPI
    url: asyncapi/grubhub-delivery-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/onboarding
- aid: grubhub:grubhub-issue-reporting-api
  name: grubhub Issue Reporting API
  description: Endpoints for reporting onboarding issues to Grubhub.
  humanURL: https://developer.grubhub.com/api/menu
  baseURL: https://api.grubhub.com
  tags:
  - Issue Reporting
  properties:
  - type: OpenAPI
    url: openapi/grubhub-issue-reporting-api-openapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/menu
  - type: GraphQL
    url: graphql/grubhub-graphql.md
  - type: Documentation
    url: https://developer.grubhub.com/api/orders
  - type: AsyncAPI
    url: asyncapi/grubhub-order-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/merchant-data
  - type: Documentation
    url: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
  - type: Documentation
    url: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
  - type: AsyncAPI
    url: asyncapi/grubhub-delivery-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/onboarding
- aid: grubhub:grubhub-menu-ingestion-api
  name: grubhub Menu Ingestion API
  description: Endpoints for uploading and managing normalized menus including schedules, sections, items, and modifiers.
  humanURL: https://developer.grubhub.com/api/menu
  baseURL: https://api.grubhub.com
  tags:
  - Menu Ingestion
  properties:
  - type: OpenAPI
    url: openapi/grubhub-menu-ingestion-api-openapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/menu
  - type: GraphQL
    url: graphql/grubhub-graphql.md
  - type: Documentation
    url: https://developer.grubhub.com/api/orders
  - type: AsyncAPI
    url: asyncapi/grubhub-order-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/merchant-data
  - type: Documentation
    url: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
  - type: Documentation
    url: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
  - type: AsyncAPI
    url: asyncapi/grubhub-delivery-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/onboarding
- aid: grubhub:grubhub-menu-retrieval-api
  name: grubhub Menu Retrieval API
  description: Endpoints for retrieving the current menu for a merchant.
  humanURL: https://developer.grubhub.com/api/menu
  baseURL: https://api.grubhub.com
  tags:
  - Menu Retrieval
  properties:
  - type: OpenAPI
    url: openapi/grubhub-menu-retrieval-api-openapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/menu
  - type: GraphQL
    url: graphql/grubhub-graphql.md
  - type: Documentation
    url: https://developer.grubhub.com/api/orders
  - type: AsyncAPI
    url: asyncapi/grubhub-order-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/merchant-data
  - type: Documentation
    url: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
  - type: Documentation
    url: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
  - type: AsyncAPI
    url: asyncapi/grubhub-delivery-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/onboarding
- aid: grubhub:grubhub-menu-schedule-overrides-api
  name: grubhub Menu Schedule Overrides API
  description: Endpoints for managing menu schedule overrides such as temporary availability changes.
  humanURL: https://developer.grubhub.com/api/menu
  baseURL: https://api.grubhub.com
  tags:
  - Menu Schedule Overrides
  properties:
  - type: OpenAPI
    url: openapi/grubhub-menu-schedule-overrides-api-openapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/menu
  - type: GraphQL
    url: graphql/grubhub-graphql.md
  - type: Documentation
    url: https://developer.grubhub.com/api/orders
  - type: AsyncAPI
    url: asyncapi/grubhub-order-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/merchant-data
  - type: Documentation
    url: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
  - type: Documentation
    url: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
  - type: AsyncAPI
    url: asyncapi/grubhub-delivery-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/onboarding
- aid: grubhub:grubhub-merchant-eligibility-api
  name: grubhub Merchant Eligibility API
  description: Endpoints for checking merchant eligibility for onboarding.
  humanURL: https://developer.grubhub.com/api/menu
  baseURL: https://api.grubhub.com
  tags:
  - Merchant Eligibility
  properties:
  - type: OpenAPI
    url: openapi/grubhub-merchant-eligibility-api-openapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/menu
  - type: GraphQL
    url: graphql/grubhub-graphql.md
  - type: Documentation
    url: https://developer.grubhub.com/api/orders
  - type: AsyncAPI
    url: asyncapi/grubhub-order-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/merchant-data
  - type: Documentation
    url: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
  - type: Documentation
    url: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
  - type: AsyncAPI
    url: asyncapi/grubhub-delivery-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/onboarding
- aid: grubhub:grubhub-merchant-onboarding-api
  name: grubhub Merchant Onboarding API
  description: Endpoints for onboarding merchants to the Grubhub platform, including referrals, activation, and association.
  humanURL: https://developer.grubhub.com/api/menu
  baseURL: https://api.grubhub.com
  tags:
  - Merchant Onboarding
  properties:
  - type: OpenAPI
    url: openapi/grubhub-merchant-onboarding-api-openapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/menu
  - type: GraphQL
    url: graphql/grubhub-graphql.md
  - type: Documentation
    url: https://developer.grubhub.com/api/orders
  - type: AsyncAPI
    url: asyncapi/grubhub-order-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/merchant-data
  - type: Documentation
    url: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
  - type: Documentation
    url: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
  - type: AsyncAPI
    url: asyncapi/grubhub-delivery-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/onboarding
- aid: grubhub:grubhub-merchant-properties-api
  name: grubhub Merchant Properties API
  description: Endpoints for updating merchant properties such as fulfillment settings and tax rates.
  humanURL: https://developer.grubhub.com/api/menu
  baseURL: https://api.grubhub.com
  tags:
  - Merchant Properties
  properties:
  - type: OpenAPI
    url: openapi/grubhub-merchant-properties-api-openapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/menu
  - type: GraphQL
    url: graphql/grubhub-graphql.md
  - type: Documentation
    url: https://developer.grubhub.com/api/orders
  - type: AsyncAPI
    url: asyncapi/grubhub-order-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/merchant-data
  - type: Documentation
    url: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
  - type: Documentation
    url: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
  - type: AsyncAPI
    url: asyncapi/grubhub-delivery-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/onboarding
- aid: grubhub:grubhub-merchant-status-api
  name: grubhub Merchant Status API
  description: Endpoints for managing merchant online/offline status on Grubhub, including soft and hard pauses.
  humanURL: https://developer.grubhub.com/api/menu
  baseURL: https://api.grubhub.com
  tags:
  - Merchant Status
  properties:
  - type: OpenAPI
    url: openapi/grubhub-merchant-status-api-openapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/menu
  - type: GraphQL
    url: graphql/grubhub-graphql.md
  - type: Documentation
    url: https://developer.grubhub.com/api/orders
  - type: AsyncAPI
    url: asyncapi/grubhub-order-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/merchant-data
  - type: Documentation
    url: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
  - type: Documentation
    url: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
  - type: AsyncAPI
    url: asyncapi/grubhub-delivery-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/onboarding
- aid: grubhub:grubhub-merchants-api
  name: grubhub Merchants API
  description: Endpoints for retrieving merchant information and ID mappings.
  humanURL: https://developer.grubhub.com/api/menu
  baseURL: https://api.grubhub.com
  tags:
  - Merchants
  properties:
  - type: OpenAPI
    url: openapi/grubhub-merchants-api-openapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/menu
  - type: GraphQL
    url: graphql/grubhub-graphql.md
  - type: Documentation
    url: https://developer.grubhub.com/api/orders
  - type: AsyncAPI
    url: asyncapi/grubhub-order-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/merchant-data
  - type: Documentation
    url: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
  - type: Documentation
    url: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
  - type: AsyncAPI
    url: asyncapi/grubhub-delivery-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/onboarding
- aid: grubhub:grubhub-order-change-requests-api
  name: grubhub Order Change Requests API
  description: Endpoints for managing order change requests and modifications.
  humanURL: https://developer.grubhub.com/api/menu
  baseURL: https://api.grubhub.com
  tags:
  - Order Change Requests
  properties:
  - type: OpenAPI
    url: openapi/grubhub-order-change-requests-api-openapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/menu
  - type: GraphQL
    url: graphql/grubhub-graphql.md
  - type: Documentation
    url: https://developer.grubhub.com/api/orders
  - type: AsyncAPI
    url: asyncapi/grubhub-order-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/merchant-data
  - type: Documentation
    url: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
  - type: Documentation
    url: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
  - type: AsyncAPI
    url: asyncapi/grubhub-delivery-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/onboarding
- aid: grubhub:grubhub-order-polling-api
  name: grubhub Order Polling API
  description: Endpoints for polling orders across multiple merchants. Webhook subscription is the preferred method for receiving
    new orders.
  humanURL: https://developer.grubhub.com/api/menu
  baseURL: https://api.grubhub.com
  tags:
  - Order Polling
  properties:
  - type: OpenAPI
    url: openapi/grubhub-order-polling-api-openapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/menu
  - type: GraphQL
    url: graphql/grubhub-graphql.md
  - type: Documentation
    url: https://developer.grubhub.com/api/orders
  - type: AsyncAPI
    url: asyncapi/grubhub-order-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/merchant-data
  - type: Documentation
    url: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
  - type: Documentation
    url: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
  - type: AsyncAPI
    url: asyncapi/grubhub-delivery-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/onboarding
- aid: grubhub:grubhub-order-status-api
  name: grubhub Order Status API
  description: Endpoints for confirming orders and updating order lifecycle states.
  humanURL: https://developer.grubhub.com/api/menu
  baseURL: https://api.grubhub.com
  tags:
  - Order Status
  properties:
  - type: OpenAPI
    url: openapi/grubhub-order-status-api-openapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/menu
  - type: GraphQL
    url: graphql/grubhub-graphql.md
  - type: Documentation
    url: https://developer.grubhub.com/api/orders
  - type: AsyncAPI
    url: asyncapi/grubhub-order-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/merchant-data
  - type: Documentation
    url: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
  - type: Documentation
    url: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
  - type: AsyncAPI
    url: asyncapi/grubhub-delivery-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/onboarding
- aid: grubhub:grubhub-orders-api
  name: grubhub Orders API
  description: Endpoints for retrieving and managing orders placed through the Grubhub Marketplace.
  humanURL: https://developer.grubhub.com/api/menu
  baseURL: https://api.grubhub.com
  tags:
  - Orders
  properties:
  - type: OpenAPI
    url: openapi/grubhub-orders-api-openapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/menu
  - type: GraphQL
    url: graphql/grubhub-graphql.md
  - type: Documentation
    url: https://developer.grubhub.com/api/orders
  - type: AsyncAPI
    url: asyncapi/grubhub-order-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/merchant-data
  - type: Documentation
    url: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
  - type: Documentation
    url: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
  - type: AsyncAPI
    url: asyncapi/grubhub-delivery-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/onboarding
- aid: grubhub:grubhub-schedule-overrides-api
  name: grubhub Schedule Overrides API
  description: Endpoints for creating and managing temporary schedule overrides such as closures and holiday hours.
  humanURL: https://developer.grubhub.com/api/menu
  baseURL: https://api.grubhub.com
  tags:
  - Schedule Overrides
  properties:
  - type: OpenAPI
    url: openapi/grubhub-schedule-overrides-api-openapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/menu
  - type: GraphQL
    url: graphql/grubhub-graphql.md
  - type: Documentation
    url: https://developer.grubhub.com/api/orders
  - type: AsyncAPI
    url: asyncapi/grubhub-order-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/merchant-data
  - type: Documentation
    url: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
  - type: Documentation
    url: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
  - type: AsyncAPI
    url: asyncapi/grubhub-delivery-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/onboarding
- aid: grubhub:grubhub-schedules-api
  name: grubhub Schedules API
  description: Endpoints for retrieving and managing merchant operating hours for delivery, pickup, and catering.
  humanURL: https://developer.grubhub.com/api/menu
  baseURL: https://api.grubhub.com
  tags:
  - Schedules
  properties:
  - type: OpenAPI
    url: openapi/grubhub-schedules-api-openapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/menu
  - type: GraphQL
    url: graphql/grubhub-graphql.md
  - type: Documentation
    url: https://developer.grubhub.com/api/orders
  - type: AsyncAPI
    url: asyncapi/grubhub-order-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/merchant-data
  - type: Documentation
    url: https://developer.grubhub.com/docs/6uXmPesMoYmoV6jZx6lVfa/checking-merchant-availability
  - type: Documentation
    url: https://developer.grubhub.com/docs/2xRv0wZtNljuMTpizzNqD2/interacting-with-drivers
  - type: AsyncAPI
    url: asyncapi/grubhub-delivery-events-asyncapi.yml
  - type: Documentation
    url: https://developer.grubhub.com/api/onboarding
common:
- type: AgenticAccess
  url: agentic-access/grubhub-agentic-access.yml
- type: DomainSecurity
  url: security/grubhub-domain-security.yml
- type: Authentication
  url: authentication/grubhub-authentication.yml
- type: OAuthScopes
  url: scopes/grubhub-scopes.yml
- type: GitHubOrganization
  url: https://github.com/GrubhubProd
- type: LinkedIn
  url: https://www.linkedin.com/company/grubhub-seamless
- type: JSONLD
  url: json-ld/grubhub-context.jsonld
- type: JSONSchema
  url: json-schema/grubhub-order-schema.json
- type: JSONSchema
  url: json-schema/grubhub-menu-schema.json
- type: JSONSchema
  url: json-schema/grubhub-merchant-schema.json
- type: Vocabulary
  url: vocabulary/grubhub-vocabulary.yml
- type: Rules
  url: rules/grubhub-spectral-rules.yml
- type: Plans
  url: plans/grubhub-plans-pricing.yml
- type: RateLimits
  url: rate-limits/grubhub-rate-limits.yml
- type: FinOps
  url: finops/grubhub-finops.yml
- type: Blog
  url: https://get.grubhub.com/blog/feed/
description: 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.