{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/grubhub/main/json-schema/grubhub-ordertypeheartbeatpayload-schema.json",
"title": "OrderTypeHeartbeatPayload",
"x-generated": "2026-09-17",
"x-method": "derived",
"x-source": "openapi/grubhub-merchant-data-openapi.yml#/components/schemas/OrderTypeHeartbeatPayload",
"required": [
"order_type_statuses"
],
"type": "object",
"properties": {
"order_type_statuses": {
"type": "object",
"additionalProperties": {
"$ref": "#/$defs/HeartbeatTriggeredPayload"
},
"description": "Map of order type to heartbeat payload. Order type keys must be valid."
}
},
"description": "Request to set merchant status online or offline for specific order types. Keys must be valid order types (e.g., 'standard', 'catering', 'group').",
"$defs": {
"HeartbeatTriggeredPayload": {
"required": [
"new_pos_status"
],
"type": "object",
"properties": {
"new_pos_status": {
"type": "string",
"description": "Merchant status, whether online/offline.",
"enum": [
"OFFLINE",
"ONLINE"
]
},
"reason": {
"type": "string",
"description": "Reason for status change"
}
},
"description": "Request to set merchant status online or offline."
}
}
}
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.