{"openapi":"3.1.0","info":{"title":"AlphaDesk Intelligence Cloud API","version":"AlphaDesk-PI-v1","description":"Property decision intelligence for banks, HFCs, developers, advisors, wealth managers and institutional investors.","contact":{"name":"AlphaDesk Enterprise","email":"enterprise@alphadesk.com"}},"servers":[{"url":"https://alphadesk360.com","description":"Production"}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Send `Authorization: Bearer ad_test_…` (sandbox) or `ad_live_…` (production)."}}},"paths":{"/api/v1/property/intelligence":{"post":{"summary":"Property Intelligence (flagship)","tags":["Property Intelligence"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"property_type":"apartment","project_name":"Prestige Falcon City","builder_name":"Prestige","city":"Bengaluru","locality":"Kanakapura Road","saleable_area_sqft":1750,"quoted_price":18500000,"buyer_objective":"self_use","holding_period_years":8}}}}}},"/api/v1/score/property":{"post":{"summary":"AlphaScore only","tags":["Property Intelligence"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"builder_name":"Sobha","locality":"Whitefield","saleable_area_sqft":1500,"quoted_price":15200000}}}}}},"/api/v1/valuation":{"post":{"summary":"Fair-value AVM","tags":["Property Intelligence"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"locality":"HSR Layout","saleable_area_sqft":1200,"quoted_price":15000000}}}}}},"/api/v1/liquidity":{"post":{"summary":"Liquidity + exit risk","tags":["Property Intelligence"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"locality":"Whitefield","saleable_area_sqft":1500,"quoted_price":15000000}}}}}},"/api/v1/negotiation":{"post":{"summary":"Negotiation range","tags":["Property Intelligence"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"locality":"Sarjapur Road","saleable_area_sqft":1750,"quoted_price":17800000}}}}}},"/api/v1/investment-analysis":{"post":{"summary":"IRR / CAGR / yield","tags":["Property Intelligence"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"locality":"Kanakapura","saleable_area_sqft":1500,"quoted_price":15000000,"holding_period_years":8}}}}}},"/api/v1/builders/{builder_name}/risk":{"get":{"summary":"Builder credibility","tags":["Builders"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}},"parameters":[{"name":"builder_name","in":"path","required":true,"schema":{"type":"string"}}]}},"/api/v1/corridors/{corridor_key}":{"get":{"summary":"Corridor intelligence","tags":["Corridors"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}},"parameters":[{"name":"corridor_key","in":"path","required":true,"schema":{"type":"string"}}]}},"/api/v1/properties/compare":{"post":{"summary":"Rank 2–10 properties","tags":["Meta"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"properties":[{"builder_name":"Prestige","locality":"Kanakapura","saleable_area_sqft":1500,"quoted_price":15000000},{"builder_name":"Sobha","locality":"Whitefield","saleable_area_sqft":1500,"quoted_price":18000000}]}}}}}},"/api/v1/property-fit":{"post":{"summary":"Buyer ↔ property fit","tags":["Property Intelligence"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"property":{"locality":"HSR Layout","saleable_area_sqft":1200,"quoted_price":15000000},"buyer_budget":14000000,"emi_comfort_monthly":90000,"investment_objective":"self_use","risk_preference":"moderate"}}}}}},"/api/v1/legal/readiness":{"post":{"summary":"Legal readiness screening","tags":["Legal"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"project_name":"Prestige Falcon City","documents_present":["sale_deed","encumbrance_certificate","khata","rera_registration","occupancy_certificate"],"rera_number":"PRM/KA/RERA/1251/446/PR/171015/000123","is_resale":false}}}}}},"/api/v1/batch/property-intelligence":{"post":{"summary":"Async batch (1-500)","tags":["Property Intelligence"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"properties":[{"builder_name":"Prestige","locality":"Kanakapura","saleable_area_sqft":1500,"quoted_price":15000000}]}}}}}},"/api/v1/batch/{batch_id}":{"get":{"summary":"Batch status + results","tags":["Batch"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}},"parameters":[{"name":"batch_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/api/v1/batch/{batch_id}/results.csv":{"get":{"summary":"Batch CSV","tags":["Batch"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}},"parameters":[{"name":"batch_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/api/v1/batch/{batch_id}/report.zip":{"get":{"summary":"Batch PDFs (zip)","tags":["Batch"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}},"parameters":[{"name":"batch_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/api/v1/me/org":{"get":{"summary":"My organisation","tags":["Me"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}}},"/api/v1/me/usage":{"get":{"summary":"My usage","tags":["Me"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}}},"/api/v1/me/webhooks":{"post":{"summary":"Create webhook","tags":["Me"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"url":"https://your-app.example.com/hooks/alphadesk","events":["batch.completed"],"description":""}}}}}},"/api/v1/status":{"get":{"summary":"Health check","tags":["Meta"],"security":[],"responses":{"200":{"description":"OK"}}}}}}