Quickstart

Use this guide to retrieve products with your API key.

Prerequisites

Before you begin, you need:

The API base URL supplied by Morabaa
An API key with the products:list scope
A tool that can send HTTP requests, such as cURL

Store your API key like a password. Never expose it in client-side code or commit it to source control.

Make a request

Set your credentials

Replace the placeholders with the values supplied by Morabaa.

export MORABAA_API_URL="https://your-api-host.example"
export MORABAA_API_KEY="mrb_yourprefix_yoursecret"

List products

Send your key in the X-Api-Key header.

curl --request GET \
  --url "$MORABAA_API_URL/external/v1/products?page=1" \
  --header "X-Api-Key: $MORABAA_API_KEY"

Read the response

A successful request returns the first 25 products in a paginated response.

{
  "items": [],
  "page": 1,
  "pageSize": 25,
  "total": 0
}

Your integration is authenticated when the API returns a 200 response. A 401 response means the key is missing, malformed, inactive, revoked, expired, or incorrect.

Next steps

Filter products

Search by category, brand, barcode, SKU, or availability.

Create an order

Submit customer, item, and delivery details.

⌘I

Getting started

API reference

Prerequisites

Make a request

Next steps

Filter products

Create an order

​Prerequisites

​Make a request

​Next steps

Filter products

Create an order

Prerequisites

Make a request

Next steps