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

# Quickstart

> Make your first request to the MyMorabaa API

## API quickstart

Use these steps to call your API for the first time.

### 1. Prepare credentials

You need:

* Base URL [https://sam.aragon.morabaa.com/api/](https://sam.aragon.morabaa.com/api/)
* `X-App-Id`
* `X-App-Secret`

<Note>
  Need credentials? Contact [info@morabaa.com](mailto:info@morabaa.com).
</Note>

If either header is missing or invalid, the API returns `401 Unauthorized`.

For `GET` requests, do not send `Content-Type: application/json`. Only include a `Content-Type` header when the request has a JSON body.

### 2. Send your first request

```bash theme={null}
curl -G "https://sam.aragon.morabaa.com/api/items" \
  -H "X-App-Id: <APP_ID>" \
  -H "X-App-Secret: <APP_SECRET>"
```

Expected result:

* Status: `200 OK`
* Body: JSON array of items

### 3. Try filters and pagination

```bash theme={null}
curl -G "https://sam.aragon.morabaa.com/api/items" \
  -H "X-App-Id: <APP_ID>" \
  -H "X-App-Secret: <APP_SECRET>" \
  --data-urlencode "query=pain" \
  --data-urlencode "limit=25" \
  --data-urlencode "offset=0"
```

Common query parameters:

* `name`, `barcode`, `groupId`
* `minBuyPrice`, `maxBuyPrice`, `minSellPrice`, `maxSellPrice`
* `buyCurrencyId`, `sellCurrencyId`, `exchangeCurrency`
* `query`, `limit`, `offset`

### 4. Read full endpoint details

<Columns cols={2}>
  <Card title="Get items endpoint" icon="terminal" href="/api-reference/endpoint/get-items">
    View full request and response details.
  </Card>

  <Card title="Get accounts endpoint" icon="terminal" href="/api-reference/endpoint/get-accounts">
    View full request and response details.
  </Card>
</Columns>