# Grubhub Merchant Schedules API

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

Grubhub Merchant Schedules API is one of 12 APIs that [Grubhub](https://apis.io/providers/grubhub/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Schedule, Availability, Hours, Restaurant, and Store Management. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Manage restaurant operating hours on Grubhub: repeating weekly schedules for delivery, pickup and catering, one-off schedule overrides for closures and special hours, and immediate open-now / close-now control.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| 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 |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/grubhub/refs/heads/main/openapi/grubhub-merchant-schedules-openapi.yml
- **OpenAPI** — https://developer.grubhub.com/resource/partner-docs/api-docs/merchant_schedule_api_final.json
- **Documentation** — https://developer.grubhub.com/api/merchant-schedules
- **APIReference** — https://developer.grubhub.com/api/merchant-schedules
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/grubhub/refs/heads/main/overlays/grubhub-merchant-schedules-overlay.yaml

## Other Grubhub APIs (11)

- [Grubhub Menu API](https://apis.io/apis/grubhub/grubhub-menu/)
- [Grubhub Orders API](https://apis.io/apis/grubhub/grubhub-orders/)
- [Grubhub Merchant Data API](https://apis.io/apis/grubhub/grubhub-merchant-data/)
- [Grubhub Busy Intervals API](https://apis.io/apis/grubhub/grubhub-busy-intervals/)
- [Grubhub Deliveries API](https://apis.io/apis/grubhub/grubhub-deliveries/)
- [Grubhub Connect (Delivery as a Service) API](https://apis.io/apis/grubhub/grubhub-connect-endpoints/)
- [Grubhub Connect Webhooks](https://apis.io/apis/grubhub/grubhub-connect-webhooks/)
- [Grubhub Onboarding API](https://apis.io/apis/grubhub/grubhub-onboarding/)
- [Grubhub Merchant Reporting API](https://apis.io/apis/grubhub/grubhub-reporting-endpoints/)
- [Grubhub Reporting Webhooks](https://apis.io/apis/grubhub/grubhub-reporting-webhooks/)
- [Grubhub Testing API](https://apis.io/apis/grubhub/grubhub-testing/)

## Tags

Schedule, Availability, Hours, Restaurant, Store Management

---

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