Developers

GET API KEY

Restaurant API


For testing purposes please use this domain - https://r-test.ordr.in/
When in production use this domain - https://r.ordr.in/

We currently have a small database of restaurants, we are actively rolling out thousands more restaurants over the course of this summer. Please bear with us and for now you can find restaurant coverage in zip codes like 77840, 31408 and 94128.


GET Delivery List: Get list of restaurants that deliver to a particular address
/dl/[datetime]/[postal code]/[city]/[street address]
Parameter Value Description
datetime Either "ASAP" or the format is [2 digit month]-[2 digit day]+[2 digit hours (24 hour clock):[2 digit minutes]
street address Street address of the delivery address
city City of the delivery address
postal code 5 digit postal code of the delivery address

It returns a JSON array of hashes. Each hash represents a restaurant and contains these fields:

id: ordr.in's restaurant identifier
na: the name of the restaurant
ad: the full address of the restaurant
del: the expected delivery time in minutes for the requested delivery time and address
mino: the minimum order for the requested delivery time and address
cu: an array of cuisines that the restaurant has described itself as
is_del: a boolean - for the given address and time, 1 means it will deliver, 0 means it will not

GET Delivery Check: Check to see if a particular restaurant delivers to an address at the specified time
/dc/[restaurant id]/[datetime]/[postal code]/[city]/[street address]
Parameter Value Description
restaurant id Ordr.in's restaurant identifier
datetime Either "ASAP" or the format is [2 digit month]-[2 digit day]+[2 digit hours (24 hour clock):[2 digit minutes]
street address Street address of the delivery address
city City of the delivery address
postal code 5 digit postal code of the delivery address

Example: /dc/142/01-21+21:30/77840/College+Station/1+Main+Street

Queries restaurant 142 for delivery on January 21st at 9:30PM to 1 Main Street, College Station 77840.

It returns a JSON hash with this data:

delivery: a boolean - for the given address and time, 1 means it will deliver, 0 means it will not
del: the expected delivery time in minutes for the requested delivery time and address
mino: the minimum order for the requested delivery time and address
meals: an array of meal names that are being delivered at the requested time
rid: the restaurant id
msg: if it is not delivering, msg contains the reason why

GET Fee: Calculates all fees for a given subtotal and delivery address, this is a superset of /dc/
/fee/[restaurant id]/[subtotal]/[tip]/[datetime]/[postal code]/[city]/[street address]
Parameter Value Description
restaurant id Ordr.in's restaurant identifier
subtotal the cost of all items in tray in dollars and cents
tip The amount of tip in dollars and cents
datetime Either "ASAP" or the format is [2 digit month]-[2 digit day]+[2 digit hours (24 hour clock):[2 digit minutes]
street address Street address of the delivery address
city City of the delivery address
postal code 5 digit postal code of the delivery address

Example: /fee/142/15.25/3/ASAP/77840/College+Station/1+Main+Street

queries for the fee that restaurant 142 will charge on a $15.25 subtotal with $3.00 tip, delivering ASAP to 1 Main Street, College Station 77840

It returns a JSON hash with this data:

delivery: a boolean - for the given address and time, 1 means it will deliver, 0 means it will not
fee: the fee to charge in dollars and cents
tax: the tax to charge in dollars and cents
del: the expected delivery time in minutes for the requested delivery time and address
mino: the minimum order for the requested delivery time and address
meals: an array of meal names that are being delivered at the requested time
rid: the restaurant id
msg: if it is not delivering, msg contains the reason why

GET Restaurant Details: provides restaurant details to allow display of a restaurant's menu page
/rd/[restaurant id]
Parameter Value Description
restaurant id Ordr.in's restaurant identifier

Example: /rd/142

queries for the basic restaurant information for restaurant 142

This returns a JSON hash with these elements:

rds_info: RDS is our Restaurant Delivery Service partner. This is itself a hash with the following fields:
logo: (optional) a url for an image file
the name of the RDS
name: the name of the restaurant
addr: the street address of the restaurant
city: the city of the restaurant
state: the state of the restaurant
postal_code: the postal_code of the restaurant
cs_contact_phone: the customer service number for the restaurant (typically this is the RDS's phone number)
meal_names: this is a hash that keys off of a meal_name_id whose value is the name of that meal
menu: this is an array of a hierarchical set of menu items, which is a hash. Each menu item has the following fields:
name: the name of the item
descrip: (optional) an optional description of the item
price: (optional) the price in dollars and cents
id: the menu item's id - this is what is used to create the tray
availability: this is an array of meal_name_id's - as referenced in the "meal_name" hash
children: this contains an array of menu_items that reside under the current one in the hierarchy.
One path down a typical hierarchy would be Appetizers -> Salad -> What dressing would you like? -> Italian

To better direct you please tell us what kind of business you are: