Decision API

Majarrah's verdict, inside your systems. One call per property.

Send a property's type, price, area and district. The API measures it against registered Ministry of Justice sales and returns a 0-100 score, a verdict, the four-part breakdown and the district benchmark, with AI reasoning in Arabic and English when you ask for it.

Create a broker account See pricing

1 API decision per scoring call
3 decisions with AI reasoning
Location lookup is free

Your listings site, your CRM, your spreadsheet: each can ask the same question Majarrah answers for buyers. Is this price right for this district? The answer comes back as data you can store, sort and show.

What it does

A scoring engine, a key and a balance.

What the API returns, how you authenticate, what it costs, and how an AI assistant can work your pipeline.

POST /v1/decisions

A score you can explain, bucket by bucket.

The response carries the verdict (match, partial or no_match), the 0-100 score and how it was built: price against the district 30%, location 20%, size 20%, details 30%, each with a pass, warn or fail status. The benchmark block gives the district's median, P25 and P75 price per m².

Five property types: apartment, villa, land, commercial, office
District by name in Arabic or English, or by ID
Optional bedrooms, bathrooms, floor, age, parking, furnished

"verdict": "match"

180 m² apartment, Al-Narjis

0/100

Price vs district30%breakdown.price79

Location20%breakdown.location90

Size20%breakdown.size97

Details30%breakdown.details65

District benchmark (/m²)benchmark

6,389

P25 5,500Median 6,573P75 8,021

5,120 registered sales, 2023-2025

reasoning: true

Add the why, in both languages.

Set reasoning to true and the same response gains a short rationale in English and in Arabic, up to three key factors and a list of risk flags, written from the score and the property you sent. If the AI step fails, the score still comes back.

reasoning_en and reasoning_ar in one call
key_factors and risk_flags as arrays
3 decisions instead of 1

reasoning

Priced about 3% under the Al-Narjis median and inside the district's middle band of sales. The size suits a three-bedroom apartment in one of Riyadh's most traded districts. Details score lowest: parking and finish are not stated.

key_factors

Below district median
High-volume district
Right size for 3 bedrooms

risk_flags

Parking not stated

Illustrative text. 3 decisions per call with reasoning.

API keys

Keys you create, see once and revoke.

Name a key in your workspace settings and it appears once, in full, for you to copy. After that the list shows only its first and last characters, when it was created and when it was last used. Revoking a key stops every request that uses it.

Sent as Authorization: Bearer sk-...
Keys belong to the workspace, not to one person
Only owners and admins create or revoke keys

API decisions

A prepaid balance, and every response tells you what is left.

API calls draw from their own balance, separate from your leads. Each response includes credits_used and credits_remaining. When the balance is too low, the API answers 402 with the amount required, so your system can stop cleanly instead of failing silently.

Packs of 100, 500 and 2,000 decisions: 49, 199 and 699
Paid by card through Geidea, in
GET /v1/locations costs nothing

500

decisions left

Top up

POST /v1/decisions reasoning: false-1
POST /v1/decisions reasoning: true-3
POST /v1/decisions reasoning: false-1
POST /v1/decisions reasoning: false-1

100

decisions

49

500

decisions

199

2,000

decisions

699

MCP server

Let an AI assistant work your inquiries and pipeline.

Majarrah also runs an MCP server. Connect an MCP-compatible AI assistant, sign in with your Majarrah account, and it can list and answer your inquiries, update bookings, move CRM leads between stages and manage your listings, using the permissions of your role.

Sign-in with OAuth; no API key is shared with the assistant
Tools for inquiries, bookings, CRM leads, listings and your workspace
Served at api.majarrah.io/mcp

Inside one call

Six steps between your request and the answer. In the same order, every time.

The same engine that scores listings for buyers on Majarrah, behind a Bearer key.

1
Key and fields checked
401 / 422
A valid Bearer key; property type, price, area and location present.
2
District resolved
district
By Arabic or English name, or by city and district IDs from /v1/locations.
3
Ministry of Justice benchmark
benchmark
Median, P25 and P75 per m² from registered sale transactions.
4
Score and verdict
score
Price 30%, location 20%, size 20%, details 30%. 70 or more is a match.
AI reasoning (optional)
reasoning
Arabic and English rationale, key factors and risk flags. If it fails, you still get the score.
6
Decisions deducted
credits
1 decision for scoring, 3 with reasoning. Decisions left come back in the response.

Decision per scoring callreasoning: false

Decisions with AI reasoningArabic and English rationale

Registered sales behind the benchmarkMinistry of Justice, 2020-2025

City districts coveredGroups with at least 3 sales

How it works

From account to first decision.

01
Create your broker account
The API lives in your workspace settings.
02
Top up API decisions
Pick 100, 500 or 2,000 decisions and pay by card.
03
Create a key
Name it and copy it while it is shown.
04
Send your first property
POST it to /v1/decisions and read the verdict.

In detail

The contract, in detail.

Location lookup

GET /v1/locations matches cities and districts in Arabic or English and returns their IDs, up to 20 results.

All districts of a city

Add districts=true to get a city with every district under it.

Readable errors

401 invalid_api_key, 422 validation_error with the field name, 402 insufficient_decisions with the balance.

Atomic deduction

Decisions are deducted in one database step, so two calls never spend the same decision.

Last used, per key

Each decision call stamps the key's last-used time in your settings.

Bilingual by default

District names in either language, reasoning in both.

Role-aware

Every member can see the masked keys; owners and admins manage them and buy decision packs.

Server-side keys

Keys are meant for your backend; the settings screen warns against client-side code.

JSON in, JSON out

Every object carries an object field: decision, list, city or district.

Why it matters

Why call an engine instead of guessing.

Pricing by handMajarrah Decision API

Reference pricePricing by hand: Other asking prices you happened to seeMajarrah Decision API: Median, P25 and P75 from registered sales in the district

ConsistencyPricing by hand: Changes with whoever checksMajarrah Decision API: Same weights and thresholds on every call

ExplanationPricing by hand: A feelingMajarrah Decision API: Four scored buckets, plus reasoning in Arabic and English on request

Cost controlPricing by hand: Hours of analyst timeMajarrah Decision API: 1 or 3 decisions, remaining count on every response

Questions

API questions, answered.

A call without reasoning costs 1 API decision; with reasoning it costs 3. Location lookups are free. Decisions come in packs of 100 ( 49), 500 ( 199) and 2,000 ( 699).

Keep exploring

Works hand in hand with

ListingsList in Arabic and English with AI descriptions and a price check against registered sales.Learn more

Lead CRMA six-stage pipeline fed by your inquiries and viewing bookings.Learn more

TeamInvite members into your workspace with roles.Learn more

For brokers who build

Put a verdict next to every price you show.

Create your broker account, top up API decisions and send your first property to /v1/decisions.

Create a broker account See pricing

Majarrah's verdict, inside your systems. One call per property.

A scoring engine, a key and a balance.

A score you can explain, bucket by bucket.

Add the why, in both languages.

Keys you create, see once and revoke.

A prepaid balance, and every response tells you what is left.

Let an AI assistant work your inquiries and pipeline.

Six steps between your request and the answer. In the same order, every time.

From account to first decision.

Create your broker account

Top up API decisions

Create a key

Send your first property

The contract, in detail.

Location lookup

All districts of a city

Readable errors

Atomic deduction

Last used, per key

Bilingual by default

Role-aware

Server-side keys

JSON in, JSON out

Why call an engine instead of guessing.

API questions, answered.

What does a call cost?

Where do the prices come from?

Are API decisions the same as leads?

Can I read my listings or leads through /v1?

Are there webhooks or a sandbox?

Who in my team can manage keys?

Works hand in hand with

Put a verdict next to every price you show.

Majarrah's verdict, inside your systems. One call per property.

A scoring engine, a key and a balance.

A score you can explain, bucket by bucket.

Add the why, in both languages.

Keys you create, see once and revoke.

A prepaid balance, and every response tells you what is left.

Let an AI assistant work your inquiries and pipeline.

Six steps between your request and the answer. In the same order, every time.

From account to first decision.

Create your broker account

Top up API decisions

Create a key

Send your first property

The contract, in detail.

Location lookup

All districts of a city

Readable errors

Atomic deduction

Last used, per key

Bilingual by default

Role-aware

Server-side keys

JSON in, JSON out

Why call an engine instead of guessing.

API questions, answered.

What does a call cost?

Where do the prices come from?

Are API decisions the same as leads?

Can I read my listings or leads through /v1?

Are there webhooks or a sandbox?

Who in my team can manage keys?

Works hand in hand with

Put a verdict next to every price you show.