{"uid":"cap__wnmorCngt8FjjAOccYc-","slug":"rafid-property-portfolio-screen-eaf27fb4","name":"Rafid Property Portfolio Screen","description":"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.","url":"https://api.rafidsystem.com/api/v1/x402/property/portfolio-screen?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":{"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."]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4YSRLQtFdx1glTUH88nqj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares and ranks a set of investment properties by net yield and financial metrics to support portfolio screening decisions.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Buy-to-let shortlist ranking","prompt":"I'm deciding between four buy-to-let properties. Can you screen them and rank by net yield? Maple Court: value £250,000, rent £16,000/year, maintenance £1,800. Brook Lane: value £180,000, rent £13,200/year, maintenance £1,200. Park View: value £350,000, rent £22,000/year, maintenance £2,500, service charge £1,000. Harbour Mews: value £420,000, rent £24,000/year, maintenance £3,000, vacancy 8%."},{"title":"Portfolio rebalancing review","prompt":"I manage a small property portfolio and want to figure out which assets are dragging down overall yield. Here are my six properties with their values, annual rents, and cost estimates — can you run a portfolio screen and sort them by net yield so I know where to focus?"},{"title":"Pre-acquisition screening","prompt":"Before I make an offer, I want to benchmark this new flat against two properties I already own. The new one is valued at £195,000, earns £12,600 rent, costs £900 maintenance and has a 3% vacancy rate. My existing ones are Birch House (£310,000 value, £19,200 rent, £2,100 maintenance) and Station Road (£275,000 value, £17,000 rent, £1,600 maintenance, £800 service charge). Which has the best net yield?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:42:43.349Z","isFirstParty":false,"canonicalSlug":"rafid-property-portfolio-screen-eaf27fb4"}