# Grubhub Orders API

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

Grubhub Orders 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 and an AsyncAPI event-driven specification. Tagged areas include Order, Order Management, Marketplace, Restaurant, and Point-of-Sale. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and an AsyncAPI specification.

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 lifecycle, raise and poll order change requests, and attach pickup instructions. New orders arrive by webhook; polling is the fallback.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| PUT | `/pos/v1/merchant/{merchant_long_id}/orders/{order_uuid}/status` | Update order status |
| GET | `/pos/v1/merchant/{merchant_long_id}/orders/{order_uuid}/changerequests` | Get status of order change request |
| POST | `/pos/v1/merchant/{merchant_long_id}/orders/{order_uuid}/changerequests` | Request change to order |
| POST | `/pos/v1/merchant/{merchant_id}/orders/{order_uuid}/addpickupinstructions` | Add Pickup Instructions |
| GET | `/pos/v1/merchant/{merchant_long_id}/orders/{order_uuid}` | Get order by order ID |
| GET | `/pos/v1/merchant/{merchant_long_id}/orders` | Get orders by merchant ID, status and date range |
| GET | `/pos/v1/group/{group_key}/orders` | Get orders by group, status and date range |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/grubhub/refs/heads/main/openapi/grubhub-orders-openapi.yml
- **OpenAPI** — https://developer.grubhub.com/resource/partner-docs/api-docs/order_api_final.json
- **Documentation** — https://developer.grubhub.com/api/orders
- **APIReference** — https://developer.grubhub.com/api/orders
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/grubhub/refs/heads/main/overlays/grubhub-orders-overlay.yaml
- **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

## Other Grubhub APIs (11)

- [Grubhub Menu API](https://apis.io/apis/grubhub/grubhub-menu/)
- [Grubhub Merchant Data API](https://apis.io/apis/grubhub/grubhub-merchant-data/)
- [Grubhub Merchant Schedules API](https://apis.io/apis/grubhub/grubhub-merchant-schedules/)
- [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

Order, Order Management, Marketplace, Restaurant, Point-of-Sale

---

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