> ## Documentation Index
> Fetch the complete documentation index at: https://docs.e-cubee.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Authenticate and make your first Morabaa Public API request.

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

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

## Make a request

<Steps>
  <Step title="Set your credentials">
    Replace the placeholders with the values supplied by Morabaa.

    ```bash theme={null}
    export MORABAA_API_URL="https://your-api-host.example"
    export MORABAA_API_KEY="mrb_yourprefix_yoursecret"
    ```
  </Step>

  <Step title="List products">
    Send your key in the `X-Api-Key` header.

    ```bash theme={null}
    curl --request GET \
      --url "$MORABAA_API_URL/external/v1/products?page=1" \
      --header "X-Api-Key: $MORABAA_API_KEY"
    ```
  </Step>

  <Step title="Read the response">
    A successful request returns the first 25 products in a paginated response.

    ```json theme={null}
    {
      "items": [],
      "page": 1,
      "pageSize": 25,
      "total": 0
    }
    ```
  </Step>
</Steps>

<Check>
  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.
</Check>

## Next steps

<CardGroup cols={2}>
  <Card title="Filter products" icon="filter" href="/api-reference/products/list-products">
    Search by category, brand, barcode, SKU, or availability.
  </Card>

  <Card title="Create an order" icon="cart-plus" href="/api-reference/orders/create-order">
    Submit customer, item, and delivery details.
  </Card>
</CardGroup>