Grubhub
Grubhub is a US online food-ordering and delivery marketplace connecting diners with local restaurants across Grubhub and Seamless. Its partner platform lets point-of-sale vendors, online-ordering providers, delivery aggregators and enterprise restaurant brands integrate directly: ingest normalized menus, receive and fulfil Marketplace orders, control merchant availability and schedules, run last-mile delivery on Grubhub's national courier network through Grubhub Connect, onboard merchants self-service, and export merchant reports. Grubhub publishes twelve first-party OpenAPI documents covering 91 operations and three egress webhooks from its partner developer portal.
Grubhub publishes 12 APIs on the APIs.io network, including Menu API, Orders API, Merchant Data API, and 9 more. Tagged areas include Food Delivery, Restaurant, Marketplace, Online Ordering, and Point-of-Sale.
The Grubhub catalog on APIs.io includes 4 event-driven AsyncAPI specifications, 1 JSON-LD context, and 3 Spectral governance rulesets.
Grubhub’s developer surface includes documentation, API reference, getting-started guide, support, pricing, signup flow, engineering blog, and 34 more developer resources.
What this lets a business do 1
Business capabilities this provider's published APIs can perform, derived from its own contracts. Browse all capabilities →
Kin Score
Kin Score
How this is scored →scored 2026-09-25 · rubric v0.23.0
APIs 12
Individual APIs this provider publishes, each with its own machine-readable definition.
Grubhub Menu API
Create, update and manage Grubhub Marketplace menus. Ingestion is diff-based against external IDs: validate a normalized menu, submit it, poll the ingestion job, and read back w...
Grubhub Orders API
Receive and manage Grubhub Marketplace orders. Retrieve an order by UUID, list a merchant's or a group's orders by status and date range, advance an order through its status lif...
Grubhub Merchant Data API
Read and maintain merchant configuration on Grubhub: profile, tax rate, delivery minimum, delivery boundaries and area fees, fulfillment estimates, pre-order window, scheduled-o...
Grubhub Merchant Schedules API
Manage restaurant operating hours on Grubhub: repeating weekly schedules for delivery, pickup and catering, one-off schedule overrides for closures and special hours, and immedi...
Grubhub Busy Intervals API
Mark a restaurant as busy for a bounded interval so Grubhub extends quoted times or pauses new orders, then read, update or clear the active interval.
Grubhub Deliveries API
Read the delivery state of a Grubhub Marketplace order, by order UUID or by delivery ID. The only operation in the whole Grubhub contract that declares a 429 lives here.
Grubhub Connect (Delivery as a Service) API
Grubhub Connect is delivery-as-a-service on Grubhub's national courier network for aggregators, marketplaces and enterprise merchants. Request and accept delivery quotes, check ...
Grubhub Connect Webhooks
The egress event contract for Grubhub Connect, published as an OpenAPI 3.1.0 webhooks-only document: Delivery Status Update (Created, Assigned, Unassigned, CourierAtPickup, Pick...
Grubhub Onboarding API
Self-service merchant onboarding for partners: list eligible merchants, refer a restaurant that is not yet on Grubhub, associate an existing merchant with the integration, activ...
Grubhub Merchant Reporting API
Asynchronous merchant report export: list the merchants enabled for reporting under a partner ID, request a report, and fetch its download URL once the report-status webhook fires.
Grubhub Reporting Webhooks
The egress event contract for merchant report exports, published as an OpenAPI 3.1.0 webhooks-only document: Report Status Update. This is the intended completion signal for a r...
Grubhub Testing API
Grubhub ships its partner test surface as part of the published contract: create a transmission test, simulate a just-in-time order event, and create a test delivery against a p...
Scroll for all 12
Pricing Plans 1
Published pricing tiers and plan structures.
Rate Limits 1
Documented rate limits and quota policies.
Grubhub Rate Limits
RATE LIMITSFinOps 1
Cost, billing, and metering signals for API financial operations.
Grubhub Finops
FINOPSEvent Specifications 4
AsyncAPI definitions for this provider's event-driven and streaming APIs.
Grubhub Connect Delivery Events
Egress webhooks Grubhub sends to a Grubhub Connect (delivery-as-a-service) partner: delivery status transitions and delivery refund updates. Derived verbatim from the webhooks o...
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...
ASYNCAPIGrubhub Merchant Reporting Events
Egress webhook Grubhub sends when a requested merchant export report changes state. This is the intended completion signal for the asynchronous Reporting API - poll only as a fa...
ASYNCAPIGrubhub Webhooks
ASYNCAPISemantic Vocabularies 1
JSON-LD contexts and semantic vocabularies used across these APIs.
Grubhub Context
JSON-LDSpectral Rules 3
Spectral governance rulesets for linting and validating these APIs.
JSON Schema 248
Standalone JSON Schema definitions for this provider's data models.
AcceptQuoteResponse
JSON SCHEMAActivateRequest
JSON SCHEMAAddLineSubstitution
JSON SCHEMAAddress
JSON SCHEMAAffiliate
JSON SCHEMAAssigned
JSON SCHEMAAssociationResponse
JSON SCHEMAAvailabilityOverride
JSON SCHEMAAvailabilityRange
JSON SCHEMABulkProcessingItemEntityStatus
JSON SCHEMACancelDeliveryRequest
JSON SCHEMACanceled
JSON SCHEMACatalogVersion
JSON SCHEMACatering
JSON SCHEMACharges
JSON SCHEMAChronology
JSON SCHEMAClientData
JSON SCHEMAConfigGroup
JSON SCHEMAContactInfo
JSON SCHEMACoordinates
JSON SCHEMACourier
JSON SCHEMACourierAtDropoff
JSON SCHEMACourierAtPickup
JSON SCHEMACreated
JSON SCHEMACreateExportReportRequestByPartner
JSON SCHEMACreateExportReportResponseByPartner
JSON SCHEMACustomScheduleMetadata
JSON SCHEMADateRange
JSON SCHEMADateTimeField
JSON SCHEMADateTimeFieldType
JSON SCHEMADateTimeZone
JSON SCHEMADeactivateRequest
JSON SCHEMADeactivateResponse
JSON SCHEMADefaultContext
JSON SCHEMADelivered
JSON SCHEMADelivery
JSON SCHEMADeliveryAddress
JSON SCHEMADeliveryArea
JSON SCHEMADeliveryAreaStats
JSON SCHEMADeliveryEvent
JSON SCHEMADeliveryInfo
JSON SCHEMADeliveryItem
JSON SCHEMADeliveryItemOption
JSON SCHEMADeliveryPreferences
JSON SCHEMADeliveryRefundUpdate
JSON SCHEMADeliverySizing
JSON SCHEMADeliveryStatusResponse
JSON SCHEMADeliveryStatusUpdate
JSON SCHEMADeliveryTestRequest
JSON SCHEMADeliveryTime
JSON SCHEMADeliveryTimes
JSON SCHEMADimensions
JSON SCHEMADiner
JSON SCHEMADinerPickUpInstructions
JSON SCHEMADropoffImageDetails
JSON SCHEMADropoffLocation
JSON SCHEMADropoffPreferences
JSON SCHEMADurationField
JSON SCHEMADurationFieldType
JSON SCHEMAEmulateDeliveryStatusUpdateWebhookRequest
JSON SCHEMAEstimatedEventTimes
JSON SCHEMAExternalId
JSON SCHEMAFeature
JSON SCHEMAFees
JSON SCHEMAFulfillmentInfo
JSON SCHEMAGeoLocation
JSON SCHEMAGeometry
JSON SCHEMAGetDownloadUrlResponseByPartner
JSON SCHEMAGetEnabledMerchantsResponse
JSON SCHEMAHeartbeatTriggeredPayload
JSON SCHEMAIncreaseTipRequest
JSON SCHEMAInstant
JSON SCHEMAInTransit
JSON SCHEMAInvalidCodeAndEntityIds
JSON SCHEMAItem
JSON SCHEMAItemDimensions
JSON SCHEMAItemSizing
JSON SCHEMAItemWeight
JSON SCHEMAJitTestOrder
JSON SCHEMAJsonNode
JSON SCHEMALeadTimeSettings
JSON SCHEMALeadTimeSettingsTier
JSON SCHEMALine
JSON SCHEMALineGroup
JSON SCHEMALineOption
JSON SCHEMALineOptionSubstitution
JSON SCHEMALineSubOption
JSON SCHEMALineSubstitutionAdjustment
JSON SCHEMALineSubstitutionReplacement
JSON SCHEMALineSubstitutionType
JSON SCHEMALineTag
JSON SCHEMALocalTime
JSON SCHEMALocation
JSON SCHEMAMassScheduleOverrideMetadata
JSON SCHEMAMeasuredPrice
JSON SCHEMAMediaValidationErrorDTO
JSON SCHEMAMenuInfo
JSON SCHEMAMenuMerchantStatus
JSON SCHEMAMenuSection
JSON SCHEMAMerchantActivationEnablementResponse
JSON SCHEMAMerchantActivationResponse
JSON SCHEMAMerchantAssociationResponse
JSON SCHEMAMerchantEligibilityResponse
JSON SCHEMAMerchantHeartbeatTriggeredPayload
JSON SCHEMAMerchantOrderTypeHeartbeatPayload
JSON SCHEMAMerchantPropertyUpdateRequest
JSON SCHEMAMerchantReportingErrorResponse
JSON SCHEMAMerchant Report Status Webhook
JSON SCHEMAMerchantStatus
JSON SCHEMAModifier
JSON SCHEMAModifierList
JSON SCHEMAModifierPrompt
JSON SCHEMAModifierPromptFreeSettings
JSON SCHEMAModifierPromptQuantitySettings
JSON SCHEMAModifierPromptSelectionSettings
JSON SCHEMAModifierQuantitySettings
JSON SCHEMANormalizedItemFulfillmentTypeSettings
JSON SCHEMANormalizedModifierFulfillmentTypeSettings
JSON SCHEMANormalizedSizedPriceFulfillmentTypeSettings
JSON SCHEMANormalizedSizeFulfillmentTypeSettings
JSON SCHEMANotificationPreferences
JSON SCHEMAOrderChangeRequest
JSON SCHEMAOrderChangeRequestStatus
JSON SCHEMAOrderFacetData
JSON SCHEMAOrderPickupInstructions
JSON SCHEMAOrderPickupVerification
JSON SCHEMAOrderProcessingInfo
JSON SCHEMAOrderTakingInfo
JSON SCHEMAOrderTypeHeartbeatPayload
JSON SCHEMAPartnerDeactivateRequest
JSON SCHEMAPartnerDeactivateResponse
JSON SCHEMAPayment
JSON SCHEMAPayments
JSON SCHEMAPeriodSchedule
JSON SCHEMAPhoneBridge
JSON SCHEMAPhoneContactDetails
JSON SCHEMAPhysicalInfo
JSON SCHEMAPickedUp
JSON SCHEMAPickupInfo
JSON SCHEMAPickupLocation
JSON SCHEMAPickupVerification
JSON SCHEMAPickupVerificationDetails
JSON SCHEMAPosAccountStatus
JSON SCHEMAPosBulkScheduleOverrideStatus
JSON SCHEMAPosBulkSupplementalTagStatus
JSON SCHEMAPosBusyInterval
JSON SCHEMAPosBusyModeRequest
JSON SCHEMAPosBusyModeResponse
JSON SCHEMAPosCustomSchedule
JSON SCHEMAPosDeleteScheduleOverride
JSON SCHEMAPosDelivery
JSON SCHEMAPosDeliveryFee
JSON SCHEMAPosEstimates
JSON SCHEMAPosEstimatesUpdateRequest
JSON SCHEMAPosFullSchedule
JSON SCHEMAPosGetBusyModeResponse
JSON SCHEMAPosItemScheduleOverrides
JSON SCHEMAPosMassScheduleOverride
JSON SCHEMAPosMerchantBatchOperationResponse
JSON SCHEMAPosMerchantBatchOperationStatus
JSON SCHEMAPosMerchantData
JSON SCHEMAPosMerchantFulfillmentInfo
JSON SCHEMAPosMerchantIntegrationStatus
JSON SCHEMAPosMerchantRepeatingIntervalRequest
JSON SCHEMAPosMerchantRepeatingSchedule
JSON SCHEMAPosModifierScheduleOverrides
JSON SCHEMAPosNormalizedMenu
JSON SCHEMAPosNormalizedMenuMedia
JSON SCHEMAPosNormalizedMenuUpdateRequest
JSON SCHEMAPosNormalizedMenuUpdateResult
JSON SCHEMAPosNormalizedMenuUpdateStatus
JSON SCHEMAPosNormalizedMenuValidationResult
JSON SCHEMAPosOrder
JSON SCHEMAPosOrderCoupon
JSON SCHEMAPosOrderMerchantData
JSON SCHEMAPosScheduleOverride
JSON SCHEMAPosScheduleOverrideBaseRequest
JSON SCHEMAPosScheduleOverrideBulkRequest
JSON SCHEMAPosScheduleOverrideMultiOperationResult
JSON SCHEMAPosScheduleOverrideRequest
JSON SCHEMAPosScheduleOverrides
JSON SCHEMAPosSupplementalTagMultiOperationResult
JSON SCHEMAPosTaxTotal
JSON SCHEMAPosTestOrderRequest
JSON SCHEMAPosUpdateRepeatingScheduleRequest
JSON SCHEMAProgressDeliveryRequest
JSON SCHEMAProgressDeliveryResponse
JSON SCHEMAProgressRefundRequest
JSON SCHEMAPromotion
JSON SCHEMAProofOfDelivery
JSON SCHEMAProperties
JSON SCHEMAProxyPhoneNumberRequest
JSON SCHEMAProxyPhoneNumberResponse
JSON SCHEMAPublicApiError
JSON SCHEMAQuantityAndWeightLineSubstitution
JSON SCHEMAQuantityLineSubstitution
JSON SCHEMAQuote
JSON SCHEMAQuoteRequest
JSON SCHEMAQuoteResponse
JSON SCHEMAReferralResponse
JSON SCHEMAReferralSignup
JSON SCHEMARefundAmount
JSON SCHEMARefundRequest
JSON SCHEMARemoveLineSubstitution
JSON SCHEMARepeatingSchedule
JSON SCHEMARepeatingScheduleMetadata
JSON SCHEMARepeatingScheduleRule
JSON SCHEMARepeatingScheduleRuleInterval
JSON SCHEMAReplaceLineSubstitution
JSON SCHEMAReportRequestParametersByPartner
JSON SCHEMAResponseWrapperAcceptQuoteResponse
JSON SCHEMAResponseWrapperDeliveryStatusResponse
JSON SCHEMAResponseWrapperProgressDeliveryResponse
JSON SCHEMAResponseWrapperProxyPhoneNumberResponse
JSON SCHEMAResponseWrapperQuoteResponse
JSON SCHEMAResponseWrapperServiceAreaResponse
JSON SCHEMARestaurantVersionId
JSON SCHEMAReturnArrived
JSON SCHEMAReturnCompleted
JSON SCHEMAReturnInitiated
JSON SCHEMAReward
JSON SCHEMAScheduledOrdersUpdateRequest
JSON SCHEMAScheduleOverride
JSON SCHEMAScheduleOverrideMetadata
JSON SCHEMAServiceAreaResponse
JSON SCHEMASize
JSON SCHEMASizedPrice
JSON SCHEMASizePrompt
JSON SCHEMAStatusUpdate
JSON SCHEMAStatusUpdateRequestPayload
JSON SCHEMASubItem
JSON SCHEMASubItemLineSubstitution
JSON SCHEMASubstitutionAdjustment
JSON SCHEMASubstitutionRequest
JSON SCHEMATag
JSON SCHEMATagProductsRequest
JSON SCHEMATaxCategory
JSON SCHEMATaxes
JSON SCHEMATaxRate
JSON SCHEMAThresholdSettings
JSON SCHEMATimePreferences
JSON SCHEMATip
JSON SCHEMATotalSubstitutionAdjustment
JSON SCHEMATriage
JSON SCHEMAUnassigned
JSON SCHEMAUpdateDeliveryDropoffLocationRequest
JSON SCHEMAVehicle
JSON SCHEMAScroll for all 248
Security Posture 2
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Scopes 1
OAuth scopes governing access to this provider's APIs.
Agentic Access 1
Recommended x-agentic-access execution contracts for AI agents.
Resources
Get Started 4
Portal, sign-up, and the first successful call
Documentation 7
Reference material describing how the API behaves
Scroll for all 7
Agent Surfaces 4
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 9
Pagination, idempotency, versioning, errors, and events
Scroll for all 9
Build 2
SDKs, sample code, and the tooling you integrate with
Access & Security 3
Authentication, authorization, and security posture
Operate 3
Status, limits, changes, and where to get help
Commercial 5
Pricing, plans, and the legal terms of use
Company 4
The organization behind the API
Source (apis.yml)
Work with this as data
Every provider here is available over the APIs.io API and to AI agents over MCP.