# Grubhub Endpoints API

**Canonical:** https://apis.io/apis/grubhub/grubhub-endpoints-api/  
**Provider:** Grubhub — https://apis.io/providers/grubhub/  
**Base URL:** https://api-third-party-gtm.grubhub.com  
**Documentation:** https://developer.grubhub.com/api/menu

Grubhub Endpoints API is one of 10 APIs that [Grubhub](https://apis.io/providers/grubhub/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and an AsyncAPI specification.

The Endpoints API from Grubhub — 61 operation(s) for endpoints.

## Operations (60 of 73)

| Method | Path | Summary |
|---|---|---|
| PUT | `/pos/v1/merchant/{merchant_id}/busy/{busy_interval_id}` | Update an active busy interval |
| GET | `/pos/v1/merchant/{merchant_id}/busy` | Get the current busy interval |
| POST | `/pos/v1/merchant/{merchant_id}/busy` | Mark restaurant as busy |
| DELETE | `/pos/v1/merchant/{merchant_id}/busy` | Clear the active busy interval |
| GET | `/pos/v1/merchant/{merchant_long_id}/orders/{order_uuid}/delivery` | Get delivery by order ID |
| GET | `/pos/v1/deliveries/{delivery_id}` | Get delivery by delivery ID |
| POST | `/pos/v1/menu/ingestion/validate` | Validate a normalized menu |
| POST | `/pos/v1/menu/ingestion` | Add or update a normalized menu |
| PATCH | `/pos/v1/merchant/{merchant_id}/menu/schedules/overrides/external` | Bulk menu item schedule override operation by external IDs |
| GET | `/pos/v1/merchant/{merchant_id}/menu/schedules/overrides` | Get schedule overrides for a merchant |
| PATCH | `/pos/v1/merchant/{merchant_id}/menu/schedules/overrides` | Bulk menu item schedule override operation by Grubhub internal IDs |
| PATCH | `/pos/v1/merchant/{merchant_id}/menu/entities/tags/alcohol` | Mark items/modifiers as alcoholic |
| GET | `/pos/v1/merchant/{merchant_id}/menu/schedules/overrides/{job_id}/status` | Get bulk schedule override job status |
| GET | `/pos/v1/merchant/{merchant_id}/menu/normalized` | Retrieve a normalized menu for a given merchant ID |
| GET | `/pos/v1/merchant/{merchant_id}/menu/entities/tags/{job_id}/status` | Check supplemental tag job status |
| GET | `/pos/v1/menu/ingestion/jobs/{job_id}` | Check ingestion job status |
| PUT | `/pos/v2/merchant/{merchant_id}/pos-status` | Set the status of a merchant to online or offline for specific order types |
| PUT | `/pos/v2/merchant/pos-status` | Set the status of a batch of merchants to online or offline by order type |
| GET | `/pos/v1/merchant/{merchant_id}/taxrate` | Get a merchant's tax rate |
| PUT | `/pos/v1/merchant/{merchant_id}/taxrate` | Update a merchant's tax rate |
| PUT | `/pos/v1/merchant/{merchant_id}/scheduledorders` | Toggle a merchant's scheduled ordering capability |
| PUT | `/pos/v1/merchant/{merchant_id}/preorderwindow` | Update a merchant's pre-order confirmable window (in minutes) |
| PUT | `/pos/v1/merchant/{merchant_id}/pos-status` | Set a merchant's status to online or offline |
| GET | `/pos/v1/merchant/{merchant_id}/fulfillment/{delivery_area_id}/deliveryfee` | Get a merchant's delivery area fee |
| PUT | `/pos/v1/merchant/{merchant_id}/fulfillment/{delivery_area_id}/deliveryfee` | Update a merchant's delivery area fee |
| GET | `/pos/v1/merchant/{merchant_id}/fulfillment/estimates` | Get a merchant's fulfillment estimates |
| PUT | `/pos/v1/merchant/{merchant_id}/fulfillment/estimates` | Update a merchant's fulfillment estimates |
| GET | `/pos/v1/merchant/{merchant_id}/fulfillment/deliveryboundaries` | Gets a merchant's delivery boundaries |
| PUT | `/pos/v1/merchant/{merchant_id}/fulfillment/deliveryboundaries` | Update a merchant's delivery boundaries |
| GET | `/pos/v1/merchant/{merchant_id}/deliveryminimum` | Get a merchant's delivery minimum |
| PUT | `/pos/v1/merchant/{merchant_id}/deliveryminimum` | Update a merchant's delivery minimum |
| PUT | `/pos/v1/merchant/properties` | Update the properties of a batch of merchants |
| PUT | `/pos/v1/merchant/pos-status` | Set the status of a batch of merchants to online or offline |
| PUT | `/pos/v1/merchant/integrationlive` | Update the live integration status of a batch of merchants |
| GET | `/pos/v2/merchant/pos-status/{batch_id}/status` | Get the online or offline status of a batch of merchants by order type |
| GET | `/pos/v1/merchant/{partner_id}/idmappings` | Get internal / external ID mappings |
| GET | `/pos/v1/merchant/{merchant_id}/fulfillment` | Get a merchant's fulfillment info |
| GET | `/pos/v1/merchant/{merchant_id}` | Get a merchant |
| GET | `/pos/v1/merchant/properties/{batch_id}/status` | Get merchant properties batch update status |
| GET | `/pos/v1/merchant/pos-status/{batch_id}/status` | Get the online or offline status of a batch of merchants |
| GET | `/pos/v1/merchant/integrationlive/{batch_id}/status` | Get the live integration status of a batch of merchants |
| GET | `/pos/v1/config/groups/{group_key}` | Get a configuration group |
| GET | `/pos/v1/merchant/{merchant_id}/schedules/repeating` | Get merchant schedules |
| PUT | `/pos/v1/merchant/{merchant_id}/schedules/repeating` | Create/Update merchant schedule |
| PUT | `/pos/v1/merchant/{merchant_id}/schedules/pickup/{schedule_version}` | Update a pickup schedule |
| PUT | `/pos/v1/merchant/{merchant_id}/schedules/delivery/{schedule_version}` | Update a delivery schedule |
| PUT | `/pos/v1/merchant/{merchant_id}/schedules/catering/{schedule_version}` | Update a catering schedule |
| GET | `/pos/v1/merchant/{merchant_id}/schedules/overrides` | Get schedule overrides |
| POST | `/pos/v1/merchant/{merchant_id}/schedules/overrides` | Add schedule override |
| DELETE | `/pos/v1/merchant/{merchant_id}/schedules/overrides` | Delete schedule override |
| POST | `/pos/v1/merchant/{merchant_id}/schedules/opennow` | Start receiving online orders |
| POST | `/pos/v1/merchant/{merchant_id}/schedules/closenow` | Stop online orders |
| GET | `/pos/v1/merchant/{merchant_id}/schedules/pickup` | Get the pickup schedule |
| GET | `/pos/v1/merchant/{merchant_id}/schedules/delivery` | Get the delivery schedule |
| GET | `/pos/v1/merchant/{merchant_id}/schedules/catering` | Get the catering schedule |
| POST | `/merchant/onboarding/v1/triage` | Report Onboarding Issue |
| POST | `/merchant/onboarding/v1/referral` | New Merchant Referral |
| POST | `/merchant/onboarding/v1/partner/deactivate` | Deactivate Merchant (Partner) |
| POST | `/merchant/onboarding/v1/partner/activate` | Activate Merchant (Partner) |
| POST | `/merchant/onboarding/v1/deactivate` | Deactivate Merchant |

…and 13 more operations. They are listed in full on the page.

## Machine-readable artifacts (30)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/grubhub/refs/heads/main/openapi/grubhub-endpoints-api-openapi.yml
- **Documentation** — https://developer.grubhub.com/api/menu
- **APIReference** — https://developer.grubhub.com/api/menu
- **Documentation** — https://developer.grubhub.com/api/orders
- **APIReference** — https://developer.grubhub.com/api/orders
- **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/grubhub/refs/heads/main/asyncapi/grubhub-order-events-asyncapi.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/grubhub/refs/heads/main/asyncapi/grubhub-webhooks.yml
- **Documentation** — https://developer.grubhub.com/api/merchant-data
- **APIReference** — https://developer.grubhub.com/api/merchant-data
- **Documentation** — https://developer.grubhub.com/api/merchant-schedules
- **APIReference** — https://developer.grubhub.com/api/merchant-schedules
- **Documentation** — https://developer.grubhub.com/api/busy-intervals
- **APIReference** — https://developer.grubhub.com/api/busy-intervals
- **Documentation** — https://developer.grubhub.com/api/deliveries
- **APIReference** — https://developer.grubhub.com/api/deliveries
- **Documentation** — https://developer.grubhub.com/api/daas-endpoints
- **APIReference** — https://developer.grubhub.com/api/daas-endpoints
- **Documentation** — https://developer.grubhub.com/api/daas-webhooks
- **APIReference** — https://developer.grubhub.com/api/daas-webhooks
- **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/grubhub/refs/heads/main/asyncapi/grubhub-delivery-events-asyncapi.yml
- **Documentation** — https://developer.grubhub.com/api/onboarding
- **APIReference** — https://developer.grubhub.com/api/onboarding
- **Documentation** — https://developer.grubhub.com/api/reporting-endpoints
- **APIReference** — https://developer.grubhub.com/api/reporting-endpoints
- **Documentation** — https://developer.grubhub.com/api/reporting-webhooks
- **APIReference** — https://developer.grubhub.com/api/reporting-webhooks
- **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/grubhub/refs/heads/main/asyncapi/grubhub-reporting-events-asyncapi.yml
- **Documentation** — https://developer.grubhub.com/api/testing
- **APIReference** — https://developer.grubhub.com/api/testing
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/grubhub/refs/heads/main/sandbox/grubhub-sandbox.yml

## Other Grubhub APIs (9)

- [Grubhub Delivery Quotes API](https://apis.io/apis/grubhub/grubhub-delivery-quotes-api/)
- [Grubhub Delivery Refunds API](https://apis.io/apis/grubhub/grubhub-delivery-refunds-api/)
- [Grubhub Delivery Service Areas API](https://apis.io/apis/grubhub/grubhub-delivery-service-areas-api/)
- [Grubhub Delivery Status API](https://apis.io/apis/grubhub/grubhub-delivery-status-api/)
- [Grubhub Delivery Tests API](https://apis.io/apis/grubhub/grubhub-delivery-tests-api/)
- [Grubhub Delivery Updates API](https://apis.io/apis/grubhub/grubhub-delivery-updates-api/)
- [Grubhub Delivery Webhooks Emulation API](https://apis.io/apis/grubhub/grubhub-delivery-webhooks-emulation-api/)
- [Grubhub Requesting Reports API](https://apis.io/apis/grubhub/grubhub-requesting-reports-api/)
- [Grubhub Webhooks API](https://apis.io/apis/grubhub/grubhub-webhooks-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/grubhub/grubhub-endpoints-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/grubhub/.