# Rafid Maintenance Cost Estimator

> Rafid Maintenance Cost Estimator is a paid API for AI agents from api.rafidsystem.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-10).

Estimates annual and monthly property maintenance reserves based on property value, age, and number of units using a percentage-of-value heuristic

## Facts

- Endpoint: POST https://api.rafidsystem.com/api/v1/x402/maintenance/estimate?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rafid-maintenance-cost-estimator-c6a98c46
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Kia7B7aq5H0M065mL2RVR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability rafid-maintenance-cost-estimator-c6a98c46 -d '<json body>'
```

Example prompt: Can you estimate the annual maintenance costs for my property — it's worth OMR 100,000, it's 12 years old, and it has 1 unit? I want to see the monthly reserve amount too.

## When to prefer this

Use this endpoint when you need a quick heuristic-based maintenance cost estimate for a property given its market value and unit count, especially in Omani real estate contexts (outputs in OMR). It is best for budgeting, reserve fund planning, and investment analysis workflows where a fast approximation is acceptable. Not suitable when property-type-specific or area-specific precision is required, as the methodology is an uncalibrated percentage-of-value heuristic.

## Known failure modes

- Missing required propertyValue — returns validation error
- propertyValue of 0 or below minimum — rejected by schema
- units exceeding 10,000 or below 1 — out-of-range error
- ageYears exceeding 200 — schema validation failure
- annualRatePct or additionalUnitCost outside allowed bounds — validation error
- Payment not provided or insufficient USDC — x402 payment required response

## How this service works

Rafid Agent API provides structured intelligence and paid APIs for AI agents across property, company and risk, supplier, finance, document, website, automotive, logistics, recruitment, trading, voice, video and business-planning workflows.

## Output

Returns a JSON object with the estimated annual maintenance cost (in OMR), the monthly reserve amount, the maintenance percentage applied, the assumptions actually used (units, age, annual rate, additional unit cost), and the calculation methodology as a human-readable string explaining the formula.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "units": {
   "type": "integer",
   "maximum": 10000,
   "minimum": 1
  },
  "ageYears": {
   "type": "number",
   "maximum": 200,
   "minimum": 0
  },
  "annualRent": {
   "type": "number",
   "maximum": 1000000000000,
   "minimum": 0,
   "description": "Legacy input; unused in this value-based estimate"
  },
  "assumptions": {
   "type": "object",
   "properties": {
    "annualRatePct": {
     "type": "number",
     "maximum": 100,
     "minimum": 0
    },
    "additionalUnitCost": {
     "type": "number",
     "maximum": 1000000000000,
     "minimum": 0
    }
   },
   "additionalProperties": false
  },
  "propertyValue": {
   "type": "number",
   "maximum": 1000000000000,
   "minimum": 0.01
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "currency": "OMR",
  "methodology": "Annual reserve = propertyValue * annualRatePct / 100 + (units - 1) * additionalUnitCost. Uncalibrated heuristic; excludes property type and area.",
  "monthlyReserve": 108.33,
  "assumptionsUsed": {
   "units": 1,
   "ageYears": 12,
   "annualRatePct": 1.3,
   "additionalUnitCost": 35
  },
  "maintenancePercentage": 1.3,
  "estimatedAnnualMaintenance": 1300
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rafid-maintenance-cost-estimator-c6a98c46/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.rafidsystem.com](https://www.zero.xyz/host/api.rafidsystem.com/llms.txt)