OpenMenu API - restaurant

Locate restaurants based on restaurant information.

http://openmenu.com/api/v1/restaurant?key=[API_KEY] + parameters

• key

  developers key for access to the API format: api key required

• output

  format of the output response format: xml | json (default: xml) not required

• offset

  offset of results to get (paging) format: integer (max 100) (default: 0) not required

• uuid

  OpenMenu ID of the menu to retrieve information about format: OpenMenu ID required if name or phone not passed

• all

  Determines if non-active restaurants are returned format: empty parameter (true if present) not required

• name

  full or partial name of a restaurant to search on format: string required if uuid or phone not passed

• phone

  restaurant phone number to search on format: string required if uuid or name not passed

• city

  full or partial city to limit update results to format: string not required

• state

  state or province to limit update results to format: 2 characters (two-digit code) not required

• postal_code

  postal_code to limit update results to format: string not required

• country

  country to limit update results to format: ISO 3166-1 alpha-2 not required

• restaurant_name

  name of the restaurant format: 2 - 255 characters

• business_type

  classification for the restaurants business type format: Franchisee | Corporate | Independent

• phone

  phone number of the restaurant (returned if phone parameter is present) format: Numeric with punctuations (allowed: #*()-/_) 7-40 characters

• address_1

  primary address of the restaurant format: 2 - 120 characters

• city_town

  city or town of the restaurant format: 2 - 50 characters

• state_province

  state or Province of the restaurant format: 2 characters (two-digit code)

• country

  country of the restaurant format: 2 characters (ISO 3166-1 alpha-2)

• latitude

  latitude for the restaurant format: 0 - 10 characters: (-)nn.nnnnnn

• longitude

  longitude for the restaurant format: 0 - 11 characters: (-)nnn.nnnnnn

• openmenu_id

  the OpenMenu ID for the restaurant format: UUID v4

• accuracy

  the Accuracy value for the restaurant format: numeric 1-9

• registrar

  registrar in control of the restaurant format: string

• date_updated

  date of last update format: yyyy-mm-dd hh:mm:ss (ISO 8601)

• omf_file_url

  OpenMenu URL for the restaurant format: 11 - 120 characters starting with http://

• status

  Status for the restaurant format: active | deleted

• 200

  successful call

• 204

  call resulted in an empty resultset

• 400

  api key is missing

• 417

  missing required parameters

• 401

  incorrect API key

<response> <api> <status></status> <api_version></api_version> <format></format> <api_key></api_key> </api> <results> <item> <restaurant_name> </restaurant_name> <business_type> </business_type> <address_1> </address_1> <city_town> </city_town> <state_province> </state_province> <country> </country> <latitude> </latitude> <longitude> </longitude> <openmenu_id> </openmenu_id> <accuracy> </accuracy> <registrar> </registrar> <date_updated> </date_updated> <omf_file_url> </omf_file_url> <status> </status> </item> <item>...</item> </results> </response>

<response> <api> <status></status> <api_version></api_version> <format></format> <api_key></api_key> </api> <results> <item> <restaurant_name> </restaurant_name> <business_type> </business_type> <phone> </phone> <address_1> </address_1> <city_town> </city_town> <state_province> </state_province> <country> </country> <latitude> </latitude> <longitude> </longitude> <openmenu_id> </openmenu_id> <accuracy> </accuracy> <registrar> </registrar> <date_updated> </date_updated> <omf_file_url> </omf_file_url> <status> </status> </item> <item>...</item> </results> </response>

<response> <api> <status></status> <api_version></api_version> <format></format> <api_key></api_key> </api> <results> <restaurant_name> </restaurant_name> <business_type> </business_type> <address_1> </address_1> <city_town> </city_town> <state_province> </state_province> <country> </country> <latitude> </latitude> <longitude> </longitude> <openmenu_id> </openmenu_id> <accuracy> </accuracy> <registrar> </registrar> <date_updated> </date_updated> <omf_file_url> </omf_file_url> <status> </status> </results> </response>

• either name, phone or uuid must be passed
• precedence for call is uuid -> name -> phone