Jentic OSThe workplace. An in-house AI platform for every employeeJentic OneSafe access. Agents reach your systems without holding keysJentic AIRThe foundation. Gets your existing platforms ready for AI
Pricing

GET STARTED

API DirectoryBrowse 10,000+ APIs ready for AI agent integrationDocumentationGuides and API reference

TOOLS

API ScoringCheck your AI readiness using our scorecardArazzo UIVisualize Arazzo workflows as interactive documentationArazzo EditorBuild and edit multi-step API workflows visually

COMMUNITY

GitHubOpen source projects and examplesOpen StandardsBuilt on open specs. Never locked in.
All ResourcesEverything in one placeBlogLatest articles and insightsTech Talk NewsletterAPIs, AI agents, architecture and strategyWebinarsLive sessions and on-demand recordingsReports & WhitepapersOriginal research on enterprise AI
About UsOur mission and teamCareersJoin our teamContactGet in touch
Try it now
Jentic OSJentic OneJentic AIR
Pricing
API DirectoryDocumentationAPI ScoringArazzo UIArazzo EditorGitHubOpen Standards
All ResourcesBlogTech Talk NewsletterWebinarsReports & Whitepapers
About UsCareersContact
Try it now
JenticJentic
Products
  • Jentic OS
  • Jentic One
  • Jentic AIR
For Developers
  • API Directory
  • Documentation
  • GitHub
Company
  • About Jentic
  • Careers
  • Contact Us
  • Trust Centre
ISO/IEC 27001:2022 certification badge issued by Prescient SecurityISO/IEC 27001:2022 certification badge issued by Prescient Security

Information Security Management System

Certified to ISO/IEC 27001:2022 by Prescient Security

AICPA SOC for Service Organizations logoAICPA SOC for Service Organizations logo

SOC 2® Type 1 report

Audited by Prescient Assurance

Terms & Conditions•Privacy Policy•
© 2026 Jentic Technology Ltd. All rights reserved.
2 Grattan Court East, Dublin, D02 VX86, Ireland
Switch to light modeSwitch to dark mode
APIs / E Commerce / Grubhub API
Grubhub API logo

Grubhub API

72
AI ReadinessAI-Aware (A-)72/100
See full scorecard
Official vendor OpenAPI document · agent-readyE CommerceOrder Managementbearer21 EndpointsREST

For Agents

Manage Grubhub restaurants, menus, availability, orders, and deliveries from a POS, OMS, or ghost-kitchen platform.

Use for: I need to confirm a new Grubhub order in our POS, Update the availability of menu item 87654 to out-of-stock, Reject an order that the kitchen cannot fulfil, Get the financial report for restaurant 123 last week

Not supported: Does not handle consumer-side ordering, payment processing, or driver dispatch outside Grubhub's network - use for restaurant partner menu, order, delivery, and report operations only.

The Grubhub API lets restaurant partners and integrators manage their presence on the Grubhub food ordering and delivery marketplace from outside the merchant portal. The 21 endpoints cover restaurant configuration, availability windows, menus and menu items, item-level availability, order intake (confirm, reject, cancel, prep time), delivery tracking, and order plus financial reports. Authentication is bearer-token based, and all calls run under https://api-gtm.grubhub.com/v1. The API is the integration surface used by point-of-sale vendors, virtual brand operators, and ghost-kitchen platforms to keep menus, hours, and order workflows in lockstep with Grubhub.

Jentic One on GithubView OpenAPI Document

Install Jentic One Beta

Connect the Grubhub API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Grubhub API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

1

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fgrubhub.com%2Fgrubhub" | sh
2

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fgrubhub.com%2Fgrubhub" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Grubhub API.

Update restaurant availability and trading hours so Grubhub stops sending orders when a kitchen is closed

Push menu and item changes from a master menu source so prices and modifiers stay in sync

Toggle item-level availability when a 86'd item runs out mid-service

Confirm, reject, or cancel incoming orders and update prep time so the customer ETA is accurate

Read delivery status for a specific order or delivery to drive tracking screens in the merchant app

Generate order and financial reports for reconciliation against the POS settlement

List orders for a restaurant on a date window for back-office workflows

Use Cases

Patterns agents use Grubhub API for, with concrete tasks.

★ POS-to-Grubhub order intake

Bring Grubhub orders into a restaurant POS in real time so the kitchen sees them on the same ticket printer as dine-in and other delivery channels. The integration accepts incoming orders, calls POST /orders/{orderId}/confirm to acknowledge, and falls back to POST /orders/{orderId}/reject when the kitchen cannot fulfil. PUT /orders/{orderId}/prep-time keeps the customer ETA accurate when the kitchen is slammed. Bearer-token auth keeps each restaurant scoped to its own location.

When a new order arrives, call POST /orders/{orderId}/confirm with the accepted prep time and write the order to the POS ticket queue.

Centralised menu management

Push a master menu (items, prices, modifiers, hours) from a multi-location menu management system into Grubhub for every restaurant the brand operates. PUT /restaurants/{restaurantId}/menus updates the menu document, PUT /restaurants/{restaurantId}/menus/{menuId}/items/{itemId} updates a single item, and PUT /restaurants/{restaurantId}/menus/{menuId}/items/{itemId}/availability handles 86's during service without a full menu push. This is the standard pattern for chains with 100+ locations.

On menu update, call PUT /restaurants/{restaurantId}/menus for each affected location and confirm the menu is live.

Reconciliation and payouts

Pull order and financial reports from Grubhub on a daily cadence and reconcile them against the POS settlement and the merchant bank deposit. GET /restaurants/{restaurantId}/reports/orders surfaces order-level totals while GET /restaurants/{restaurantId}/reports/financials returns the financial summary, and GET /restaurants/{restaurantId}/orders backstops disputes by listing the underlying orders. The output flows into the accounting system for monthly close.

Pull GET /restaurants/{restaurantId}/reports/financials for yesterday and write the totals into the accounting daybook.

AI agent integration through Jentic

Expose Grubhub operations to a restaurant ops agent through Jentic so managers can ask things like 'mark item Spicy Tuna as out of stock at the downtown location' or 'reject any pending order from store 42'. The agent searches Jentic for the right intent, loads the operation schema, and executes it. Jentic stores the Grubhub bearer token in its vault so the agent only ever sees a scoped Jentic agent key.

Through Jentic, search 'confirm a Grubhub order', load the operation, and execute it for the order id arriving in the queue.

Key Endpoints

21 endpoints — the grubhub api lets restaurant partners and integrators manage their presence on the grubhub food ordering and delivery marketplace from outside the merchant portal.

METHOD

PATH

DESCRIPTION

GET

/restaurants/{restaurantId}

Get restaurant configuration

PUT

/restaurants/{restaurantId}/menus

Update menus for a restaurant

PUT

/restaurants/{restaurantId}/menus/{menuId}/items/{itemId}/availability

Toggle item-level availability

POST

/orders/{orderId}/confirm

Confirm an inbound order

POST

/orders/{orderId}/reject

Reject an order

PUT

/orders/{orderId}/prep-time

Update the prep time on an order

GET

/restaurants/{restaurantId}/reports/financials

Pull financial reports for reconciliation

GET

/restaurants/{restaurantId}

Get restaurant configuration

PUT

/restaurants/{restaurantId}/menus

Update menus for a restaurant

PUT

/restaurants/{restaurantId}/menus/{menuId}/items/{itemId}/availability

Toggle item-level availability

POST

/orders/{orderId}/confirm

Confirm an inbound order

POST

/orders/{orderId}/reject

Reject an order

PUT

/orders/{orderId}/prep-time

Update the prep time on an order

GET

/restaurants/{restaurantId}/reports/financials

Pull financial reports for reconciliation

Jentic AI Readiness Score

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

G

Grubhub API

- AI-Aware (A-)
72/100
99
Foundational Compliance
63
Developer Experience & Jentic Compatibility
57
AI-Readiness & Agent Experience
94
Agent Usability
75
Security
69
AI Discoverability
Powered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
99

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: A+Signals: 4
97%

Lint Results

Aggregated quality score from linter diagnostics, weighted by severity.

100%

Resolution Completeness

Percentage of `$ref` references that resolve successfully.

100%

Specification Validity

Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).

100%

Structural Integrity

Structural correctness score based on schema issues using logarithmic dampening.

63

Developer Experience & Jentic Compatibility

Clarity, completeness, and ingestion readiness for developers and tooling.

Grade: B-Signals: 4
0%

Example Density

How richly the API is illustrated with examples.

100%

Example Validity

Percentage of examples that conform to their schemas.

50%

Response Coverage

Percentage of operations with complete response definitions (success, client error, server error).

100%

Tooling Readiness

Health of API ingestion, bundling, and resolution within Jentic pipelines.

57

AI-Readiness & Agent Experience

Semantic breadth, depth, and agent comprehension for AI systems.

Grade: CSignals: 4
74%

Description Coverage

Coverage of descriptions across API elements.

0%

Error Standardization

Coverage of RFC 9457 Problem Details for error responses.

100%

OperationId Quality

Coverage, uniqueness, and casing consistency of operationIds for AI inference.

54%

Summary Coverage

Coverage of summaries across operations/tags/info.

94

Agent Usability

Functional utility, complexity comfort, and AI orchestration readiness.

Grade: A+Signals: 1
94%

Complexity Comfort

Agent comfort level based on API operational and structural complexity.

75

Security

Trust, risk posture, and security compliance.

Grade: A-Signals: 1
75%

Authentication Strength

Average quality of security schemes based on authentication method strength (weakest link for OAuth2).

69

AI Discoverability

Findability, semantic richness, and reasoning readiness.

Grade: B+Signals: 1
69%

Descriptive Richness

Clarity and depth of descriptions across API elements.

View full reportHow the score is calculatedMore about the dimensions

Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

Score your own APIScoring CLI agent skill
npx @jentic/api-scorecard-cli score <openapi-url>

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the Grubhub API by hand means handling its bearer auth against the api-gtm.grubhub.com host and managing menu, order, and report pagination and retries across many restaurants yourself. Through Jentic you install once, import Grubhub from the API Directory, store the token once, and your agent calls it.

Permission scoping

Grubhub puts the restaurant id and order id in the URL path (/restaurants/{restaurantId}/..., /orders/{orderId}/...), so a rule can pin your agent to one restaurant or one order: it can update that restaurant's menu and item availability and nothing else. You choose the operations it may call, so rejecting an order is not included unless you add it.

Credential isolation

Your Grubhub bearer token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context, which matters for multi-location and multi-brand operators.

Intent-based discovery

Agents search Jentic by intent such as 'confirm a Grubhub order' or 'update item availability', and Jentic returns the matching operation with its input schema, including the required restaurantId, orderId, and itemId, so the agent calls the right endpoint without browsing the reference docs.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Postmates API

→

On-demand delivery API for restaurants and stores

Choose Postmates when the priority is on-demand same-day delivery beyond food; choose Grubhub for the food-ordering marketplace and menu integration.

Complementary

Shopify API

→

E-commerce platform for online stores

Use Shopify for the merchant's direct online store and Grubhub for the third-party food-delivery marketplace channel of the same brand.

Complementary

Square API

→

Restaurant point-of-sale and payments platform

Use Square as the in-restaurant POS and Grubhub for inbound delivery orders that need to land in the same kitchen ticket queue.

FAQs

Specific to using Grubhub API through Jentic.

What authentication does the Grubhub API use?

Grubhub uses bearer-token authentication. Partner integrations exchange OAuth-style credentials for a bearer token and send it as Authorization: Bearer <token> on every request. Through Jentic the bearer token lives in the vault and the agent calls Jentic with a scoped agent key (ak_*) rather than the raw Grubhub token.

Can I confirm and reject orders programmatically?

Yes. POST /orders/{orderId}/confirm acknowledges an order, POST /orders/{orderId}/reject sends a rejection, and POST /orders/{orderId}/cancel handles cancellations. PUT /orders/{orderId}/prep-time updates the customer ETA when the kitchen revises the time required.

What are the rate limits for the Grubhub API?

Grubhub does not encode hard limits in the public spec. Their gateway throttles at the partner level; back off on HTTP 429 responses and stagger menu pushes across locations rather than firing them simultaneously.

How do I update item availability quickly through Jentic?

Install Jentic with pip install jentic, search for 'update Grubhub item availability', load the matching operation, and execute it with the restaurant id, menu id, item id, and availability flag. Jentic resolves the call to PUT /restaurants/{restaurantId}/menus/{menuId}/items/{itemId}/availability.

Can I pull financial reports for accounting reconciliation?

Yes. GET /restaurants/{restaurantId}/reports/financials returns the financial summary for a restaurant over a date window, and GET /restaurants/{restaurantId}/reports/orders returns the underlying order-level data. Together they support a daily reconciliation against bank deposits.

How do I track a delivery for an order in flight?

Call GET /orders/{orderId}/delivery-status for the order or GET /deliveries/{deliveryId} when you have the delivery id. POST /deliveries/{deliveryId}/update lets a partner driver app push status updates back into Grubhub.

Can I limit what my agent is allowed to do with the Grubhub API?

Yes. Because you run Jentic One yourself, your own rules decide which Grubhub operations and credentials the agent may use. Grubhub carries the restaurant id and order id in the URL path (/restaurants/{restaurantId}/..., /orders/{orderId}/...), so you can pin the agent to a single restaurant or order and allow only the calls you intend, such as updating a menu and toggling item availability with PUT /restaurants/{restaurantId}/menus/{menuId}/items/{itemId}/availability. Operations you do not grant, like POST /orders/{orderId}/reject, stay off limits unless you add them.

GET STARTED

Start building with Grubhub API

Explore with Jentic One
View OpenAPI Document