{
  "info": {
    "name": "AlphaDesk Intelligence Cloud",
    "_postman_id": "adk-294ff661",
    "description": "Property decision intelligence API. Paste your sandbox key into the {{api_key}} variable to run every request.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Property Intelligence",
      "item": [
        {
          "name": "POST /api/v1/property/intelligence",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/property/intelligence",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "property",
                "intelligence"
              ]
            },
            "description": "Property Intelligence (flagship)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"property_type\": \"apartment\",\n  \"project_name\": \"Prestige Falcon City\",\n  \"builder_name\": \"Prestige\",\n  \"city\": \"Bengaluru\",\n  \"locality\": \"Kanakapura Road\",\n  \"saleable_area_sqft\": 1750,\n  \"quoted_price\": 18500000,\n  \"buyer_objective\": \"self_use\",\n  \"holding_period_years\": 8\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "POST /api/v1/score/property",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/score/property",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "score",
                "property"
              ]
            },
            "description": "AlphaScore only",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"builder_name\": \"Sobha\",\n  \"locality\": \"Whitefield\",\n  \"saleable_area_sqft\": 1500,\n  \"quoted_price\": 15200000\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "POST /api/v1/valuation",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/valuation",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "valuation"
              ]
            },
            "description": "Fair-value AVM",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"locality\": \"HSR Layout\",\n  \"saleable_area_sqft\": 1200,\n  \"quoted_price\": 15000000\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "POST /api/v1/liquidity",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/liquidity",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "liquidity"
              ]
            },
            "description": "Liquidity + exit risk",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"locality\": \"Whitefield\",\n  \"saleable_area_sqft\": 1500,\n  \"quoted_price\": 15000000\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "POST /api/v1/negotiation",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/negotiation",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "negotiation"
              ]
            },
            "description": "Negotiation range",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"locality\": \"Sarjapur Road\",\n  \"saleable_area_sqft\": 1750,\n  \"quoted_price\": 17800000\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "POST /api/v1/investment-analysis",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/investment-analysis",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "investment-analysis"
              ]
            },
            "description": "IRR / CAGR / yield",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"locality\": \"Kanakapura\",\n  \"saleable_area_sqft\": 1500,\n  \"quoted_price\": 15000000,\n  \"holding_period_years\": 8\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "POST /api/v1/properties/compare",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/properties/compare",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "properties",
                "compare"
              ]
            },
            "description": "Rank 2\u201310 properties",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"properties\": [\n    {\n      \"builder_name\": \"Prestige\",\n      \"locality\": \"Kanakapura\",\n      \"saleable_area_sqft\": 1500,\n      \"quoted_price\": 15000000\n    },\n    {\n      \"builder_name\": \"Sobha\",\n      \"locality\": \"Whitefield\",\n      \"saleable_area_sqft\": 1500,\n      \"quoted_price\": 18000000\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "POST /api/v1/property-fit",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/property-fit",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "property-fit"
              ]
            },
            "description": "Buyer \u2194 property fit",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"property\": {\n    \"locality\": \"HSR Layout\",\n    \"saleable_area_sqft\": 1200,\n    \"quoted_price\": 15000000\n  },\n  \"buyer_budget\": 14000000,\n  \"emi_comfort_monthly\": 90000,\n  \"investment_objective\": \"self_use\",\n  \"risk_preference\": \"moderate\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Builders / Corridors",
      "item": [
        {
          "name": "GET /api/v1/builders/{builder_name}/risk",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/builders/{builder_name}/risk",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "builders",
                "{builder_name}",
                "risk"
              ]
            },
            "description": "Builder credibility"
          }
        },
        {
          "name": "GET /api/v1/corridors/{corridor_key}",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/corridors/{corridor_key}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "corridors",
                "{corridor_key}"
              ]
            },
            "description": "Corridor intelligence"
          }
        }
      ]
    },
    {
      "name": "Legal",
      "item": [
        {
          "name": "POST /api/v1/legal/readiness",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/legal/readiness",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "legal",
                "readiness"
              ]
            },
            "description": "Legal readiness screening",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"project_name\": \"Prestige Falcon City\",\n  \"documents_present\": [\n    \"sale_deed\",\n    \"encumbrance_certificate\",\n    \"khata\",\n    \"rera_registration\",\n    \"occupancy_certificate\"\n  ],\n  \"rera_number\": \"PRM/KA/RERA/1251/446/PR/171015/000123\",\n  \"is_resale\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Batch",
      "item": [
        {
          "name": "POST /api/v1/batch/property-intelligence",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/batch/property-intelligence",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "batch",
                "property-intelligence"
              ]
            },
            "description": "Async batch (1-500)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"properties\": [\n    {\n      \"builder_name\": \"Prestige\",\n      \"locality\": \"Kanakapura\",\n      \"saleable_area_sqft\": 1500,\n      \"quoted_price\": 15000000\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "GET /api/v1/batch/{batch_id}",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/batch/{batch_id}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "batch",
                "{batch_id}"
              ]
            },
            "description": "Batch status + results"
          }
        },
        {
          "name": "GET /api/v1/batch/{batch_id}/results.csv",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/batch/{batch_id}/results.csv",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "batch",
                "{batch_id}",
                "results.csv"
              ]
            },
            "description": "Batch CSV"
          }
        },
        {
          "name": "GET /api/v1/batch/{batch_id}/report.zip",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/batch/{batch_id}/report.zip",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "batch",
                "{batch_id}",
                "report.zip"
              ]
            },
            "description": "Batch PDFs (zip)"
          }
        }
      ]
    },
    {
      "name": "Organisation",
      "item": [
        {
          "name": "GET /api/v1/me/org",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/me/org",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "me",
                "org"
              ]
            },
            "description": "My organisation"
          }
        },
        {
          "name": "GET /api/v1/me/usage",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/me/usage",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "me",
                "usage"
              ]
            },
            "description": "My usage"
          }
        },
        {
          "name": "POST /api/v1/me/webhooks",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{api_key}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/me/webhooks",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "me",
                "webhooks"
              ]
            },
            "description": "Create webhook",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"url\": \"https://your-app.example.com/hooks/alphadesk\",\n  \"events\": [\n    \"batch.completed\"\n  ],\n  \"description\": \"\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Meta",
      "item": [
        {
          "name": "GET /api/v1/status",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/status",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "status"
              ]
            },
            "description": "Health check"
          }
        }
      ]
    }
  ],
  "variable": [
    {
      "key": "base_url",
      "value": "https://alphadesk360.com",
      "type": "string"
    },
    {
      "key": "api_key",
      "value": "ad_test_paste_your_sandbox_key_here",
      "type": "string"
    }
  ]
}