Skip to main content
POST
Create a Decision
Not sure which city or district name to use? Use GET /locations to search by name and get the exact numeric IDs to pass here.

Request body

object
required
The property to evaluate.
object
required
Property location. Pass either numeric IDs (recommended) from GET /locations, or raw string names.
boolean
required
false - algorithmic scoring only (1 decision). Returns score and breakdown instantly.true - scoring + AI reasoning (3 decisions). Adds a reasoning object with English and Arabic explanations.

Response

string
Always "decision".
string
match, partial, or no_match. Derived from score: 70+ is match, 40–69 is partial, below 40 is no match.
number
Overall score from 0 to 100.
object
Per-bucket scores and statuses.
number
Calculated price per square meter for this property.
object | null
MOJ market data used for price scoring. null if no benchmark exists for the given city/district.
object
Only present when reasoning: true.
number
Decisions consumed by this request. 1 for scoring only, 3 for reasoning.
number
Your remaining decision balance after this request.

Examples