HomeGuidesAPI Reference
Log In
API Reference

Getting Started

This page will help you get started with MealMe API.

API for out-of-the-box checkout from millions of stores for delivery & pickup.

About MealMe

MealMe started as a consumer app that helped consumers to find the best deal on delivery from restaurants and grocery stores. At first, we linked out to 3rd party websites to order (like KAYAK). We decided that we needed users to stay on the MealMe app to order (like Expedia), so we searched for an API that would pull menus/inventory and inject orders into the POS of restaurants, grocery stores, and retail stores. We found nothing. So, we made the first universal menu/inventory Data and Ordering API to power our consumer app, which we grew to 1M+ users. After countless requests from other companies to use our technology we decided to pivot to an API only company and offer our technology to other companies. We spent an entire year documenting, perfecting, and adding selection to include 800M+ products from 1M+ restaurants, grocery stores, convenience stores, and retail stores in the US and Canada. MealMe has raised a total of $16M in venture capital and is now the menu/inventory and ordering infrastructure of over 100 customers, from startups to billion dollar companies.

Getting your API Key

  • To get an API key, request access by filling out the form here.

Glossary

  • _id - A unique MealMe ID used to represent a restaurant or store.
  • quote_id - A MealMe ID used to represent a delivery/pickup service supported by a restaurant/store. This ID changes with each API request (even for the same delivery/pickup service), however, old quote IDs do not get invalidated.
  • product_id - A MealMe ID used represent a restaurant menu item or store product. Similarly to quote IDs, product IDs change with each API request (even for the same product), however, old product IDs do not get invalidated.
  • option_id - A MealMe ID that represents a menu item's or store product's customization option. Similarly to product IDs, this ID changes with each API request, but old option IDs don't get invalidated.
  • quote - This is the object that includes a delivery/pickup service's time estimates, delivery fees, service fees, order minimum, etc. for a particular store and delivery address. This is retrieved by making a request to /restaurants/details/quotes or /groceries/details/quotes with a quote_id and delivery address.

Status Codes:

We get alerted of anything that's not a 200. If it's urgent, do not hesitate to email [email protected].

200 OK - Response to a successful request.

400 Bad Request - Malformed request; request body validation errors.

401 Unauthorized - When no or invalid authentication details are provided.

403 Forbidden - When authentication succeeded but authenticated user doesn't have access to the resource.

404 Not Found - When a non-existent endpoint is requested.

406 Unavailable - When a delivery or pickup service or store is unavailable. Please refer here for a complete list of failure reasons.

422 Unprocessable Entity - The request was well-formed but was unable to be not acceptable.

500 Server Error - The server encountered an unexpected condition which prevented it from completing the request.

501 Not Implemented - The HTTP method is not supported by the server and cannot be handled.

502 Bad Gateway - The server got an invalid response while working as a gateway to get a response needed to handle the request.

503 Service Unavailable - The server is not ready to handle the request.

504 Gateway Timeout - The server is acting as a gateway and cannot get a response in time for a request.

Quote Unavailable Status Codes

406 DELIVERY_NOT_AVAILABLE - Delivery is currently unavailable for this store.

406 PICKUP_NOT_AVAILABLE - Pickup is currently unavailable for this store.

406 STORE_CLOSED - This store is closed.

406 OUT_OF_RANGE - This store is out of range for the provided address.

406 STORE_NOT_AVAILABLE - This store is not available.

406 INVALID_PAYLOAD - The payload is not valid.

406 QUOTE_NOT_AVAILABLE - The selected quote is not available.

406 USER_ERROR- User error. Check the input.

Accessing the Self Serve API

For a custom integration, volume pricing & invoicing, please schedule a meeting here: mealme.ai

The Menu & Food Delivery & Grocery API can be accessed here:
mealme.ai

The Places & Checkout API can be accessed here:
mealme.ai

Support

For any questions, do not hesitate to reach out: