BringMeThat

Find restaurants on BringMeThat that deliver to, or offer pickup near, a US location. Returns restaurant_id, cuisines, distance when a street address is given, Yelp rating when one is on file, and the restaurant page URL. Ask for a ZIP code, city and state, or street address before calling if you do not already have it.

{
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "description": "ZIP code, 'City, ST', or a full US street address (best: gives distances)."
    },
    "query": {
      "type": "string",
      "description": "Cuisine, dish or restaurant name, e.g. 'thai', 'pizza', 'pad see ew'. Omit for everything nearby."
    },
    "fulfillment": {
      "type": "string",
      "enum": [
        "delivery",
        "pickup"
      ],
      "default": "delivery"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 8
    }
  },
  "required": [
    "location"
  ],
  "additionalProperties": false
}

Get a restaurant's BringMeThat menu: sections, items with item_id, descriptions, prices, and option groups (including which ones are required). Prices are item prices; checkout adds the fees create_checkout_link describes. Use restaurant_id from search_restaurants. Large menus can be narrowed with section or search.

{
  "type": "object",
  "properties": {
    "restaurant_id": {
      "type": "integer"
    },
    "section": {
      "type": "string",
      "description": "Only sections whose name contains this, e.g. 'noodles'."
    },
    "search": {
      "type": "string",
      "description": "Only items whose name or description contains this, e.g. 'vegetarian'."
    }
  },
  "required": [
    "restaurant_id"
  ],
  "additionalProperties": false
}

Build a bringmethat.com checkout link for the customer's items. Opening checkout_url fills their cart and opens bringmethat.com checkout, where they review the total and pay. Does not charge a card and does not place the order. Validates items and required options first and returns prices, or the problems to fix with the customer. Checkout is the item total plus a 10% markup, the restaurant's own service fee (none for partner restaurants; there is no flat service fee), tax, a $7 delivery fee ($0 for pickup) unless a Habitat or MealMe delivery quote replaces it, and an optional tip. Premium ($9.95/month or $96/year) waives the markup and the service fee, but not delivery, tax, or tip. The card is authorized for that total plus $15 when the total is over $30, otherwise plus 45%. Only the final amount is charged.

{
  "type": "object",
  "properties": {
    "restaurant_id": {
      "type": "integer"
    },
    "fulfillment": {
      "type": "string",
      "enum": [
        "delivery",
        "pickup"
      ]
    },
    "delivery_address": {
      "type": "string",
      "description": "Street address for delivery, e.g. '2415 N Ashland Ave, Chicago, IL 60614'. Prefills checkout."
    },
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 30,
      "items": {
        "type": "object",
        "required": [
          "item_id",
          "quantity"
        ],
        "properties": {
          "item_id": {
            "type": "string",
            "description": "item_id from get_menu, e.g. '0.2.0.5'."
          },
          "quantity": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20
          },
          "options": {
            "type": "array",
            "description": "Choices for the item's option groups. Use group_index and option names exactly as get_menu lists them. Required groups must be filled.",
            "items": {
              "type": "object",
              "required": [
                "group_index",
                "choices"
              ],
              "properties": {
                "group_index": {
                  "type": "integer",
                  "minimum": 0
                },
                "choices": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "minItems": 1
                }
              }
            }
          },
          "special_instructions": {
            "type": "string",
            "maxLength": 200
          }
        }
      }
    }
  },
  "required": [
    "restaurant_id",
    "fulfillment",
    "items"
  ],
  "additionalProperties": false
}

Read the status of a BringMeThat order. Does not change the order. Needs the order number (starts with R) and the email used at checkout; details are returned only when both match.

{
  "type": "object",
  "properties": {
    "order_number": {
      "type": "string",
      "description": "e.g. R123456789"
    },
    "email": {
      "type": "string"
    }
  },
  "required": [
    "order_number",
    "email"
  ],
  "additionalProperties": false
}