HomeGuidesAPI Reference
Log In

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 was started in 2018. The Food API has powered the MealMe app in 2021 to earn millions in sales, ranking as one of the Top 50 Food & Drink apps for the entire year and getting featured as App of The Day.

Download the MealMe app as a live demonstration of what The Food API can power: mealme.ai

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: