{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/grubhub/main/json-schema/grubhub-merchantstatus-schema.json",
"title": "MerchantStatus",
"x-generated": "2026-09-17",
"x-method": "derived",
"x-source": "openapi/grubhub-merchant-data-openapi.yml#/components/schemas/MerchantStatus",
"type": "object",
"properties": {
"merchant_id": {
"type": "string",
"description": "The Grubhub(internal) or Partner(external) merchant ID."
},
"status": {
"type": "string",
"description": "Status of the bulk processing operation, one of SUCCESSFUL, NOT_FOUND, INVALID, FAILED, FAILED_TO_QUEUE, IN_PROGRESS, REQUESTED."
},
"details": {
"type": "string",
"description": "Additional details present in case of a NOT_FOUND / INVALID status."
}
},
"description": "Merchant ID and their bulk processing status, including additional information in case of NOT_FOUND / INVALID statuses."
}
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.