AVENAAPIP v1.0

Avena Property Intelligence Protocol (APIP) v1.0

The Open Standard for European Property Data

Like OpenAPI for REST. Like HL7 for healthcare. APIP for property.

What is APIP?

APIP (Avena Property Intelligence Protocol) defines a universal JSON schema for property intelligence records. It standardises how deal scores, rental yields, developer ratings, market regime classifications, carbon ratings, and location intelligence are encoded, exchanged, and consumed across the European property ecosystem.

Any platform, agent, or API that speaks APIP can interoperate with the Avena Terminal ecosystem and every other APIP-compliant system. One schema. One language. Every property.

Full Schema Specification

The APIP property record format. Every field is documented in the downloadable JSON Schema.

apip-record.jsonDownload Schema
{
  "$schema": "https://avenaterminal.com/standards/apip-v1.json",
  "apip_version": "1.0",
  "property": {
    "id": "AVE-CB-00142",
    "deal_score": 78,
    "yield_gross": 7.2,
    "developer_rating": "AV",
    "market_regime": "buyer_opportunity",
    "liquidity_score": 64,
    "carbon_rating": "B",
    "apci_at_listing": 62.4,
    "location": {
      "town": "Finestrat",
      "region": "Costa Blanca",
      "country": "ES",
      "coordinates": { "lat": 38.5653, "lng": -0.2187 },
      "beach_km": 3.2
    },
    "pricing": {
      "asking_price": 285000,
      "price_per_m2": 2850,
      "market_reference": 3120
    },
    "specifications": {
      "built_m2": 100,
      "bedrooms": 3,
      "bathrooms": 2,
      "pool": "communal",
      "energy": "B",
      "status": "key_ready"
    }
  }
}

Field Reference

deal_scoreinteger (0-100)Composite investment score. 70+ strong, 80+ institutional grade.
yield_grossnumber (%)Estimated gross rental yield from bottom-up ADR model.
developer_ratingenumDeveloper quality tier: AAV (top), AV, ABV, BBV, CV, DV (unrated).
market_regimeenumCurrent market phase: buyer_opportunity, balanced, seller_premium, overheated, correction.
liquidity_scoreinteger (0-100)Estimated time-to-sale score. Higher = faster liquidity.
carbon_ratingstring (A-G)Energy/carbon efficiency of the property.
apci_at_listingnumberAvena Property Consciousness Index value at time of listing.
locationobjectTown, region, country, coordinates, and beach proximity in km.
pricingobjectAsking price, price per m2, and hyperlocal market reference.
specificationsobjectBuilt area, bedrooms, bathrooms, pool, energy cert, build status.

Reference Implementation

Avena Terminal is the reference implementation of APIP. Every property record served through the Avena API, MCP server, and A2A agent network conforms to APIP v1.0.

avenaterminal.com/mcp

Adopt APIP

01

Implement the Schema

Map your property data to the APIP JSON Schema. Use the downloadable schema for validation.

02

Submit for Validation

Send a sample payload to the APIP validation endpoint. We verify schema conformance and data quality.

03

Get Listed as APIP-Compliant

Receive the APIP-compliant badge and get listed in the Avena Terminal partner directory.

Submit to Standards Bodies

APIP is being submitted for review and adoption by the following industry and regulatory bodies:

W3CWeb Data Standards — JSON-LD, Schema.org vocabulary alignment
Schema.orgRealEstateListing type extension proposal for investment intelligence fields
EU Digital Single MarketEuropean Commission property data portability under Digital Markets Act
RICSRoyal Institution of Chartered Surveyors — valuation data interchange
European PropTech AssociationIndustry standard for PropTech data interoperability across EU markets