Skip to main content

API quickstart

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

1. Prepare credentials

You need: If either header is missing or invalid, the API returns 401 Unauthorized.

2. Send your first request

curl -G "https://sam.aragon.morabaa.com/api/items" \
  -H "X-App-Id: <APP_ID_GUID>" \
  -H "X-App-Secret: <APP_SECRET>"
Expected result:
  • Status: 200 OK
  • Body: JSON array of items

3. Try filters and pagination

curl -G "https://sam.aragon.morabaa.com/api/items" \
  -H "X-App-Id: <APP_ID_GUID>" \
  -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

Get items endpoint

View full request and response details.