# Rafid Property Portfolio Screen

> Rafid Property Portfolio Screen is a paid API for AI agents from api.rafidsystem.com, paid per call via x402, $0.5/call, status unknown (last checked 2026-10-10).

Compares and ranks a set of investment properties by net yield and financial metrics to support portfolio screening decisions.

## Facts

- Endpoint: POST https://api.rafidsystem.com/api/v1/x402/property/portfolio-screen?utm_source=zero.xyz
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rafid-property-portfolio-screen-eaf27fb4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__wnmorCngt8FjjAOccYc-

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-property-portfolio-screen-eaf27fb4 -d '<json body>'
```

Example prompt: I have three rental properties I want to compare — 12 Oak Street valued at £300,000 with £18,000 annual rent and £2,000 maintenance, Flat 4B valued at £200,000 with £14,400 annual rent and £1,500 maintenance, and River House valued at £500,000 with £28,000 annual rent, £3,000 maintenance and a 5% vacancy rate. Can you screen all three and tell me which has the best net yield?

## When to prefer this

Use this endpoint when you need to compare 2–100 investment properties side-by-side on financial performance metrics, especially net yield, in a single structured call. Prefer it over manual calculations or general-purpose LLM reasoning when you need deterministic, reproducible yield rankings across a portfolio. It is not a substitute for full property due diligence (ownership verification, tax, financing) but is ideal for shortlisting and prioritisation tasks.

## Known failure modes

- Fewer than 2 properties supplied — minimum 2 required
- Property missing required fields (name, propertyValue, annualRent) — validation error
- Both 'maintenance' and 'maintenanceCost' supplied simultaneously — schema conflict
- Property value of 0 or negative — validation error
- More than 100 properties submitted — exceeds maxItems limit
- Payment not completed via x402 — 402 Payment Required response
- Extremely large numeric values exceeding 1,000,000,000,000 — schema validation failure

## 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 containing a list of all submitted properties with computed financial metrics (such as net yield) and a second list sorted by net yield descending, allowing direct comparison. Includes a workflow identifier and limitations note clarifying that ownership, taxes, financing and transaction costs are not verified.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "propertyValue",
     "annualRent",
     "name"
    ],
    "properties": {
     "name": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1
     },
     "annualRent": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0
     },
     "maintenance": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0,
      "description": "Legacy alias for maintenanceCost; supply only one"
     },
     "propertyValue": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0.01
     },
     "serviceCharge": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0
     },
     "vacancyRatePct": {
      "type": "number",
      "maximum": 100,
      "minimum": 0
     },
     "maintenanceCost": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0
     },
     "otherAnnualCosts": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "maxItems": 100,
   "minItems": 2
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "properties": [],
   "sortedByNetYield": []
  },
  "workflow": "portfolio_screen",
  "limitations": [
   "This screen compares supplied properties; it does not verify ownership, financing, taxes or transaction costs."
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rafid-property-portfolio-screen-eaf27fb4/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)