AlphaDesk Intelligence Cloud API.

A REST API that returns scored, reason-coded, source-backed property intelligence. Designed for lenders, developers, advisors, wealth managers and institutional investors who need a defensible, programmatic property-decision layer.

1. Get an API key

Email enterprise@alphadesk.com to request a sandbox key. Test keys are prefixed ad_test_, live keys ad_live_. Full keys are shown exactly once; store them securely and rotate on schedule.

2. Make your first call

curl -X POST https://alphadesk360.com/api/v1/property/intelligence \
  -H "Authorization: Bearer ad_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "project_name": "Prestige Falcon City",
    "builder_name": "Prestige",
    "city": "Bengaluru",
    "locality": "Kanakapura Road",
    "saleable_area_sqft": 1750,
    "quoted_price": 18500000
  }'

Bearer API keys

Every request must include a valid API key in the Authorization: Bearer … header. Keys are scoped to a single organisation and environment (test or live). Revoked keys immediately return HTTP 401 with code INVALID_API_KEY.

Authorization: Bearer ad_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Default sandbox: 100 requests / minute per key. Live production limits are configured per organisation in your enterprise contract. Exceeding the limit returns HTTP 429 with a Retry-After header.

Errors use standard HTTP status codes and a structured JSON body:

{
  "error": {
    "code": "PROPERTY_NOT_FOUND",
    "message": "Unable to match the supplied project with sufficient confidence.",
    "request_id": "ADI-20260815-93B27014"
  }
}

POST /property/intelligence

Submit property details and receive a full decision packet: AlphaScore + component scores, fair-value band, negotiation band, IRR scenarios, risk flags with reason codes, confidence, provenance and a structured decision verdict.

Request body

{
  "property_type": "apartment | villa | plot | commercial | land",
  "project_name": "Prestige Falcon City",
  "builder_name": "Prestige",
  "city": "Bengaluru",
  "locality": "Kanakapura Road",
  "corridor_key": "kanakapura",
  "saleable_area_sqft": 1750,
  "carpet_area_sqft": 1450,
  "quoted_price": 18500000,
  "buyer_objective": "self_use | rental | investment",
  "holding_period_years": 8,
  "down_payment": 7000000,
  "loan_rate": 8.5
}

Response envelope

{
  "request_id": "ADI-20260815-93B27014",
  "timestamp": "2026-08-15T16:52:11Z",
  "model_version": "AlphaDesk-PI-v1",
  "benchmark_version": "2026.07",
  "status": "ok | insufficient_data",
  "scores": {
    "alpha_score": 74,
    "builder_score": 82,
    "liquidity_score": 78,
    "location_score": 80,
    "legal_readiness_score": null,
    "investment_score": 71
  },
  "valuation": {
    "fair_value_low": 15925000,
    "fair_value_high": 17755000,
    "confidence": 0.89,
    "quoted_price_deviation_percent": 8.3,
    "rate_per_sqft_used": 9100
  },
  "negotiation": {
    "recommended_opening_offer": 15288000,
    "recommended_buy_ceiling": 17755000,
    "maximum_rational_price": 18110100
  },
  "returns": {
    "estimated_rental_yield_percent": 3.2,
    "base_case_irr_percent": 12.0,
    "bear_case_irr_percent": 7.0,
    "bull_case_irr_percent": 16.0
  },
  "risk": { "overall": "MODERATE", "flags": [ /* reason objects */ ] },
  "decision": {
    "verdict": "BUY | BUY_WITH_CONDITIONS | NEGOTIATE | WAIT | SKIP",
    "summary": "Strong fundamentals; quoted price above fair-value band."
  },
  "reasons": [
    { "code": "PRICE_ABOVE_MARKET", "impact": -10, "detail": "..." },
    { "code": "STRONG_BUILDER_HISTORY", "impact": +6, "detail": "..." }
  ],
  "provenance": [ /* per-signal source + as_of */ ],
  "sources": [ /* human-readable citation list */ ],
  "confidence_score": 0.89,
  "disclaimer": "Indicative decision-support intelligence …"
}

Field notes

• · alpha_score — composite 0–100. Weights: location 30% · liquidity 20% · demand 20% · builder 15% · price-fit 15%.
• · confidence_score — 0.0–1.0. Derived from resolvable signals (corridor + builder + area + quoted price).
• · status: "insufficient_data" is returned when we cannot resolve enough signals to produce a scored packet. No scores are fabricated.
• · reasons[] — signed impact values in AlphaScore points; enterprise callers can display, aggregate or export these directly.
• · provenance[] — per-signal source metadata (source, source_type, as_of).

Run a real request from your browser.

Pick an endpoint, edit the JSON body, hit Run request. No key required. Every call hits the same intelligence engine as production via a rate-limited public sandbox (12 calls / minute per IP).

// Click "Run request" to see the response here.

GET /status

Unauthenticated health check. Returns model_version, benchmark_version, and a UTC timestamp.

Building next

These endpoints follow the same envelope contract as /property/intelligence. Availability windows are shared with enterprise design partners on request.

• POST /valuationAVM · fair-value band
• POST /score/propertyAlphaScore standalone + reason codes
• POST /liquidityLiquidity score + exit-risk classification
• GET /builders/{id}/riskBuilder credibility index
• POST /legal/readinessDocument-based legal readiness screening
• GET /corridors/{id}Corridor intelligence packet
• POST /rental-analysisEstimated rent + yield
• POST /investment-analysisIRR, CAGR, break-even scenarios
• POST /negotiationFair-value band + negotiation range
• POST /property-fitBuyer ↔ property fit scoring
• POST /properties/compareRanked comparison of 2–10 properties
• POST /land/intelligenceLocation + document intelligence for land parcels
• POST /alphax/queryReasoning layer over the AlphaDesk graph
• POST /batch/property-intelligenceAsync bulk scoring for lenders
• POST /portfolio/analysePortfolio-level risk, concentration, IRR