Skip to main content

OrderingPlus API Guidelines

The purpose of this guide is to explain the usage of the OrderingPlus API in a straightforward manner. We will delve into the key usage points of the API along with some illustrative examples.

Written by Yair
Updated over a year ago

What is the OrderingPlus API?


OrderingPlus is the best and easiest way to build any kind of OrderingPlus Solution. You can even create your Online OrderingPlus Marketplace; our APIs include all the power of our backend, so you don't need to build one to create amazing Apps or OrderingPlus Solutions.

Like any API, certain functions are defined that can be used to interact with your OrderingPlus project and utilize its resources.

Requirements for using the OrderingPlus API

  • OrderingPlus Project ID: The identifier should not contain spaces and must be in lowercase (It is automatically created based on your project name).

  • X-API-KEY: This key is used as authentication for requests made to the API. You can obtain it in your dashboard under the Settings/Pro/Developers/API Keys section/Add API key:

    Annotation on 2024-09-26 at 18-02-23.png


  • API Request Testing Tool: In this guide, we will use "Postman," but you can use any other similar tool.

  • Endpoint URL: In this guide, we will explain how to use the main endpoints.

  • Web browser with developer tools, such as Google Chrome

Get Order List

You can obtain the list of orders that belong to your project and apply filters to them

Usage example

Annotation on 2024-09-26 at 18-18-37.png

Filters for Orders list

It's possible to retrieve the list of orders using specific filters. This allows for more specific order retrieval. Some of the filters that can be used include:

  • Status

  • Range date

  • Customer email

Usage example

Annotation on 2024-09-26 at 20-50-07.png

Annotation on 2024-09-26 at 20-52-15.png

Get Businesses List

You can obtain the complete list of your businesses from your project.

Usage example:

The easiest way to request the list of businesses is through the following endpoint:

NOTE: Don't forget to replace "<project_id>" with your project's identifier and <language_code> with “en” or with the code of your language.

Now, you simply need to use the endpoint using the "GET" request type and add your "x-api-key" as the "Authorization" of the request.

Usage example

Annotation on 2024-09-26 at 18-31-30.png

When attempting this, you may encounter an error due to the potentially high payload of requested data in JSON format. To address this, parameters should be used.

For example, if we only want to request the "name" value of the business, we can add these parameters to the request. Additionally, we include "page=1&page_size=10" to limit the result per page:

Usage example

Annotation on 2024-09-26 at 18-37-25.png

The API will return reduced information, including only some minimal data. If you want to add additional data, you just need to include it, for example, the "location":

Annotation on 2024-09-26 at 18-40-34.png

We can also observe that the same endpoint is used in the dashboard but with additional parameters added. This can be useful for comparing information regarding the usage of certain endpoints:


Annotation on 2024-09-26 at 18-44-30.png

Annotation on 2024-09-26 at 18-46-36.png

Some parameters compatible with the business endpoint are:

  • external_id

  • featured

  • enabled

  • reviews

  • delivery_price

  • delivery_time

  • slug

  • pickup_time

  • categories: This parameter may increase the request load; we do not recommend using it for this endpoint.

Get Categories and Products from the Store

To get categories and product info, the following endpoint can be used:

To send this request, a "GET" method is used, and it requires using the Authorization with an x-api-key, as you can see in the following image:

Usage example

Annotation on 2024-09-26 at 20-56-41.png

You can view the products within each category.

Did this answer your question?