analyze_oman_property

Analyze an Oman residential property using local rental comparables, market context and investment metrics, including partner-supplied historical and recent Al Mouj Muscat property sales records with provenance and freshness metadata when coverage is available.

When to use

Use when an agent needs Oman-specific rental, yield, sale price positioning or operating-cost analysis, especially for an Al Mouj Muscat property.

Selection guidance

Role: primary. Oman-specific property analysis with local comparables; Al Mouj or Muscat rental and sale positioning

Not for: a property outside the supported Oman market; a simple yield calculation with supplied numbers

Use cases

Access

Price: $0.25 USD per call. Payment options are deployment-configured; inspect /api/v1/payment-methods. Prices and payment semantics are unchanged from the canonical registry.

Related tools

Example input

{
  "governorate": "Muscat",
  "area": "Al Mouj",
  "propertyType": "apartment",
  "bedrooms": 2,
  "sizeSqm": 130,
  "askingPriceOMR": 118000
}

Example output

{
  "normalizedLocation": {
    "governorate": "Muscat",
    "wilayat": "Muscat",
    "area": "Al Mouj",
    "inputArea": "Al Mouj",
    "matchType": "exact",
    "supported": true
  },
  "subjectProperty": {
    "propertyType": "apartment",
    "bedrooms": 2,
    "bathrooms": null,
    "sizeSqm": 130,
    "askingPriceOMR": 118000,
    "furnished": "unspecified"
  },
  "market": {
    "estimatedMonthlyRentOMR": {
      "low": 696.43,
      "median": 731.25,
      "high": 731.85
    },
    "estimatedAnnualRentOMR": 8775,
    "comparableCount": 4,
    "sampleSizeUsed": 3,
    "dataFreshnessDays": 185
  },
  "investment": {
    "grossYieldPct": 7.44,
    "estimatedOperatingCostOMR": 0,
    "estimatedNetIncomeOMR": 8775,
    "netYieldPct": 7.44
  },
  "pricePosition": {
    "askingPricePerSqmOMR": 907.69,
    "observedComparableRange": null,
    "marketPosition": "insufficient_data"
  },
  "comparablesSummary": {
    "medianRentPerSqm": 5.63,
    "lowRentPerSqm": 5.36,
    "highRentPerSqm": 5.63
  },
  "riskFlags": [
    "outliers_removed",
    "insufficient_sale_market_data",
    "demo_dataset_not_live_market_data"
  ],
  "confidence": {
    "score": 0.73,
    "level": "high",
    "reasons": [
      "Sample size of 3 comparable(s) used (target is 8+ for full confidence on this factor).",
      "Comparable data has a median age of 185 day(s) (data older than 540 days is excluded before this point).",
      "Comparable size deviates 4% from the subject on average; 100% of comparables match the bedroom count exactly.",
      "Price dispersion across comparables (coefficient of variation) is 0.02.",
      "1 statistical outlier(s) were removed from the comparable pool before scoring."
    ]
  },
  "provenance": [
    {
      "sourceType": "manual_benchmark",
      "sourceName": "Rafid curated Muscat benchmark dataset (demo/MVP — illustrative figures, not sourced from live listings or completed transactions)",
      "sourceDate": "2026-06-01",
      "recordCount": 5
    }
  ],
  "assumptions": [
    "No annual service charge supplied; treated as 0 OMR in operating cost.",
    "No annual maintenance cost supplied; treated as 0 OMR in operating cost.",
    "1 statistical outlier(s) were removed from the rental comparable sample.",
    "Some or all comparable figures come from a curated demo/MVP benchmark dataset (see provenance); they are illustrative, not sourced from live listings or completed transactions."
  ],
  "insufficientMarketData": false,
  "unavailableOutputs": [
    "pricePosition.observedComparableRange",
    "pricePosition.marketPosition"
  ],
  "currency": "OMR",
  "dataQuality": {
    "latestDataDate": "2026-05-25",
    "dataFreshnessDays": 185,
    "sampleSize": 3,
    "sourceTypes": [
      "manual_benchmark"
    ],
    "staleMarketData": false
  },
  "officialMarketContext": {
    "available": false,
    "reason": "ncsi_not_configured",
    "source": "National Centre for Statistics and Information (NCSI)",
    "sourceType": "official_statistics",
    "governorate": "Muscat",
    "period": null,
    "realEstatePriceIndex": {
      "value": null,
      "period": null
    },
    "marketActivity": {
      "tradedValueOMR": null,
      "saleContracts": null,
      "mortgageContracts": null
    },
    "dataFreshnessDays": null,
    "confidence": {
      "level": "unavailable",
      "reasons": [
        "No verified NCSI dataset/field mapping is configured for this deployment."
      ]
    },
    "provenance": {
      "source": "National Centre for Statistics and Information (NCSI)",
      "sourceType": "official_statistics",
      "datasetId": null,
      "datasetTitle": null,
      "retrievedAt": null,
      "publishedAt": null,
      "sourceUrl": null,
      "license": "Open Government License – Sultanate of Oman"
    }
  }
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "governorate": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "wilayat": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "area": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "propertyType": {
      "type": "string",
      "enum": [
        "apartment",
        "villa",
        "townhouse"
      ]
    },
    "bedrooms": {
      "type": "integer",
      "minimum": 0,
      "maximum": 20
    },
    "bathrooms": {
      "type": "integer",
      "minimum": 0,
      "maximum": 20
    },
    "sizeSqm": {
      "type": "number",
      "minimum": 10,
      "maximum": 5000
    },
    "askingPriceOMR": {
      "type": "number",
      "minimum": 1000,
      "maximum": 1000000000
    },
    "furnished": {
      "type": "string",
      "enum": [
        "furnished",
        "semi_furnished",
        "unfurnished"
      ]
    },
    "optionalAnnualServiceChargeOMR": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000
    },
    "optionalAnnualMaintenanceOMR": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000
    }
  },
  "required": [
    "governorate",
    "area",
    "propertyType",
    "sizeSqm",
    "askingPriceOMR"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "normalizedLocation": {
      "type": "object",
      "properties": {
        "governorate": {
          "type": "string"
        },
        "wilayat": {
          "type": "string"
        },
        "area": {
          "type": "string"
        },
        "inputArea": {
          "type": "string"
        },
        "matchType": {
          "type": "string",
          "enum": [
            "exact",
            "alias",
            "unmatched"
          ]
        },
        "supported": {
          "type": "boolean"
        }
      },
      "required": [
        "governorate",
        "wilayat",
        "area",
        "inputArea",
        "matchType",
        "supported"
      ],
      "additionalProperties": false
    },
    "subjectProperty": {
      "type": "object",
      "properties": {
        "propertyType": {
          "type": "string",
          "enum": [
            "apartment",
            "villa",
            "townhouse"
          ]
        },
        "bedrooms": {
          "type": [
            "number",
            "null"
          ]
        },
        "bathrooms": {
          "type": [
            "number",
            "null"
          ]
        },
        "sizeSqm": {
          "type": "number"
        },
        "askingPriceOMR": {
          "type": "number"
        },
        "furnished": {
          "type": "string",
          "enum": [
            "furnished",
            "semi_furnished",
            "unfurnished",
            "unspecified"
          ]
        }
      },
      "required": [
        "propertyType",
        "bedrooms",
        "bathrooms",
        "sizeSqm",
        "askingPriceOMR",
        "furnished"
      ],
      "additionalProperties": false
    },
    "market": {
      "type": "object",
      "properties": {
        "estimatedMonthlyRentOMR": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "low": {
                  "type": "number"
                },
                "median": {
                  "type": "number"
                },
                "high": {
                  "type": "number"
                }
              },
              "required": [
                "low",
                "median",
                "high"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "estimatedAnnualRentOMR": {
          "type": [
            "number",
            "null"
          ]
        },
        "comparableCount": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "sampleSizeUsed": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "dataFreshnessDays": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "estimatedMonthlyRentOMR",
        "estimatedAnnualRentOMR",
        "comparableCount",
        "sampleSizeUsed",
        "dataFreshnessDays"
      ],
      "additionalProperties": false
    },
    "investment": {
      "type": "object",
      "properties": {
        "grossYieldPct": {
          "type": [
            "number",
            "null"
          ]
        },
        "estimatedOperatingCostOMR": {
          "type": "number"
        },
        "estimatedNetIncomeOMR": {
          "type": [
            "number",
            "null"
          ]
        },
        "netYieldPct": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "grossYieldPct",
        "estimatedOperatingCostOMR",
        "estimatedNetIncomeOMR",
        "netYieldPct"
      ],
      "additionalProperties": false
    },
    "pricePosition": {
      "type": "object",
      "properties": {
        "askingPricePerSqmOMR": {
          "type": "number"
        },
        "observedComparableRange": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "low": {
                  "type": "number"
                },
                "median": {
                  "type": "number"
                },
                "high": {
                  "type": "number"
                }
              },
              "required": [
                "low",
                "median",
                "high"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "marketPosition": {
          "type": "string",
          "enum": [
            "below_market",
            "at_market",
            "above_market",
            "insufficient_data"
          ]
        }
      },
      "required": [
        "askingPricePerSqmOMR",
        "observedComparableRange",
        "marketPosition"
      ],
      "additionalProperties": false
    },
    "comparablesSummary": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "medianRentPerSqm": {
              "type": "number"
            },
            "lowRentPerSqm": {
              "type": "number"
            },
            "highRentPerSqm": {
              "type": "number"
            }
          },
          "required": [
            "medianRentPerSqm",
            "lowRentPerSqm",
            "highRentPerSqm"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "riskFlags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "confidence": {
      "type": "object",
      "properties": {
        "score": {
          "type": "number",
          "minimum": 0,
          "maximum": 1
        },
        "level": {
          "type": "string",
          "enum": [
            "insufficient",
            "low",
            "medium",
            "high"
          ]
        },
        "reasons": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "score",
        "level",
        "reasons"
      ],
      "additionalProperties": false
    },
    "provenance": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "sourceType": {
            "type": "string",
            "enum": [
              "official_statistics",
              "listing_asking_price",
              "manual_benchmark",
              "partner_feed"
            ]
          },
          "sourceName": {
            "type": "string"
          },
          "sourceDate": {
            "type": "string"
          },
          "recordCount": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "sourceType",
          "sourceName",
          "sourceDate",
          "recordCount"
        ],
        "additionalProperties": false
      }
    },
    "assumptions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "insufficientMarketData": {
      "type": "boolean"
    },
    "unavailableOutputs": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "currency": {
      "type": "string",
      "const": "OMR"
    },
    "dataQuality": {
      "type": "object",
      "properties": {
        "latestDataDate": {
          "type": [
            "string",
            "null"
          ]
        },
        "dataFreshnessDays": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "sampleSize": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "sourceTypes": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "official_statistics",
              "listing_asking_price",
              "manual_benchmark",
              "partner_feed"
            ]
          }
        },
        "staleMarketData": {
          "type": "boolean"
        }
      },
      "required": [
        "latestDataDate",
        "dataFreshnessDays",
        "sampleSize",
        "sourceTypes",
        "staleMarketData"
      ],
      "additionalProperties": false
    },
    "historicalSalesContext": {
      "type": "object",
      "properties": {
        "available": {
          "type": "boolean"
        },
        "recordsAvailable": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "recentComparableSales": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "medianHistoricalPricePerSqmOMR": {
          "type": [
            "number",
            "null"
          ]
        },
        "recentMedianPricePerSqmOMR": {
          "type": [
            "number",
            "null"
          ]
        },
        "oldestRecordDate": {
          "type": [
            "string",
            "null"
          ]
        },
        "latestRecordDate": {
          "type": [
            "string",
            "null"
          ]
        },
        "sourceTypes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "priceSemantics": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "phaseBreakdown": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "phaseName": {
                "type": "string"
              },
              "recordCount": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "medianPriceOMR": {
                "type": "number"
              },
              "medianPricePerSqmOMR": {
                "type": "number"
              },
              "oldestRecordDate": {
                "type": "string"
              },
              "latestRecordDate": {
                "type": "string"
              }
            },
            "required": [
              "phaseName",
              "recordCount",
              "medianPriceOMR",
              "medianPricePerSqmOMR",
              "oldestRecordDate",
              "latestRecordDate"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "available",
        "recordsAvailable",
        "recentComparableSales",
        "medianHistoricalPricePerSqmOMR",
        "recentMedianPricePerSqmOMR",
        "oldestRecordDate",
        "latestRecordDate",
        "sourceTypes",
        "priceSemantics",
        "phaseBreakdown"
      ],
      "additionalProperties": false
    },
    "officialMarketContext": {
      "type": "object",
      "properties": {
        "available": {
          "type": "boolean"
        },
        "reason": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "ncsi_not_configured",
                "no_data_for_governorate",
                "ncsi_timeout",
                "ncsi_malformed_response",
                "official_source_temporarily_unavailable"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "source": {
          "type": "string"
        },
        "sourceType": {
          "type": "string",
          "const": "official_statistics"
        },
        "governorate": {
          "type": "string"
        },
        "period": {
          "type": [
            "string",
            "null"
          ]
        },
        "realEstatePriceIndex": {
          "type": "object",
          "properties": {
            "value": {
              "type": [
                "number",
                "null"
              ]
            },
            "period": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "value",
            "period"
          ],
          "additionalProperties": false
        },
        "marketActivity": {
          "type": "object",
          "properties": {
            "tradedValueOMR": {
              "type": [
                "number",
                "null"
              ]
            },
            "saleContracts": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "mortgageContracts": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "tradedValueOMR",
            "saleContracts",
            "mortgageContracts"
          ],
          "additionalProperties": false
        },
        "dataFreshnessDays": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "confidence": {
          "type": "object",
          "properties": {
            "level": {
              "type": "string",
              "enum": [
                "unavailable",
                "low",
                "medium",
                "high"
              ]
            },
            "reasons": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "required": [
            "level",
            "reasons"
          ],
          "additionalProperties": false
        },
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "sourceType": {
              "type": "string",
              "const": "official_statistics"
            },
            "datasetId": {
              "type": [
                "string",
                "null"
              ]
            },
            "datasetTitle": {
              "type": [
                "string",
                "null"
              ]
            },
            "retrievedAt": {
              "type": [
                "string",
                "null"
              ]
            },
            "publishedAt": {
              "type": [
                "string",
                "null"
              ]
            },
            "sourceUrl": {
              "type": [
                "string",
                "null"
              ]
            },
            "license": {
              "type": "string"
            }
          },
          "required": [
            "source",
            "sourceType",
            "datasetId",
            "datasetTitle",
            "retrievedAt",
            "publishedAt",
            "sourceUrl",
            "license"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "available",
        "reason",
        "source",
        "sourceType",
        "governorate",
        "period",
        "realEstatePriceIndex",
        "marketActivity",
        "dataFreshnessDays",
        "confidence",
        "provenance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "normalizedLocation",
    "subjectProperty",
    "market",
    "investment",
    "pricePosition",
    "comparablesSummary",
    "riskFlags",
    "confidence",
    "provenance",
    "assumptions",
    "insufficientMarketData",
    "unavailableOutputs",
    "currency",
    "dataQuality",
    "historicalSalesContext",
    "officialMarketContext"
  ],
  "additionalProperties": false
}

Category: Property Intelligence · hierarchy: primary · idempotent: yes · side effects: no