Authentication - Majarrah Docs

The Majarrah API is available to broker and agency accounts only. If you signed up as a buyer or seller, API keys are not available on your account.

Get your API key

API keys are managed from your dashboard. Go to Dashboard → Settings → API Keys at www.majarrah.io/ar/dashboard/settings/api-keys and click New key. Each key is tied to your workspace’s decision balance.

Keep your API key secret. Never expose it in client-side code or public repositories.

Using your key

Pass the key as a Bearer token in the Authorization header on every request.

Authorization: Bearer YOUR_API_KEY

Example

curl -X POST https://api.majarrah.io/v1/decisions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "property": {
      "type": "apartment",
      "price": 850000,
      "area": 95,
      "bedrooms": 2,
      "bathrooms": 2,
      "floor": 8
    },
    "location": {
      "city": "Al Khobar",
      "district": "Al Corniche"
    },
    "reasoning": false
  }'

Decision balance

Every API key is tied to your workspace’s decision balance. You can check your remaining balance in the response of any /decisions call via decisions_remaining, or from Dashboard → Settings → API Credits. When your balance reaches zero, all requests return 402 insufficient_decisions until you top up.