# Grubhub Merchant Data API

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

Grubhub Merchant Data 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 Merchants, Merchant Data, Configuration, Restaurant, and Store Management. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Read and maintain merchant configuration on Grubhub: profile, tax rate, delivery minimum, delivery boundaries and area fees, fulfillment estimates, pre-order window, scheduled-ordering opt-in, and online/offline status by order type. Batch writes return a batch handle that is polled to completion.

## Operations (26)

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

## Machine-readable artifacts (5)

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

Merchants, Merchant Data, Configuration, Restaurant, Store Management

---

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