Find Similar Projects

​

Path Parameters

​

Authentication & Authorization

• Required: Valid JWT token or API key
• Permissions: User must have admin authority within their organization
• Community Access: Organization must be a member of at least one active community

​

Response Structure

​

Example Response

{
  "developments": [
    {
      "name": "Primary Development",
      "profile": {
        "function": "Educational",
        "process": "New Build"
      },
      "mandatory": "New Build Education",
      "results": [
        {
          "similarity": 0.85,
          "details": {
            "id": "community_project_12345",
            "footprint_cost": 1250000,
            "total_cost": 2100000,
            "total_gifa": 3500,
            "site_area": 8000,
            "latitude": 51.5,
            "longitude": -0.1,
            "contract_start_date": "2023-03-15T00:00:00.000Z"
          },
          "location": {
            "index": 88.5,
            "region": "South East"
          },
          "time": {
            "index": 95.2
          },
          "features": [
            "Sustainable Design",
            "Modern Construction Methods",
            "Urban Location",
            "Multi-Storey",
            "Steel Frame Construction"
          ],
          "report": {
            "matches": [
              "Building Function: Educational",
              "Construction Process: New Build",
              "Sustainable Design Features",
              "Steel Frame Construction",
              "Urban Site Location"
            ],
            "differences": [
              "Site Area: 20% larger",
              "GIFA: 15% smaller",
              "Contract Start: 6 months earlier"
            ],
            "score_breakdown": {
              "mandatory_match": 1.0,
              "feature_similarity": 0.82,
              "scale_similarity": 0.78,
              "location_similarity": 0.91,
              "overall_score": 0.85
            }
          }
        },
        {
          "similarity": 0.78,
          "details": {
            "id": "community_project_67890",
            "footprint_cost": 980000,
            "total_cost": 1850000,
            "total_gifa": 3200,
            "site_area": 7200,
            "latitude": 51.4,
            "longitude": -0.3,
            "contract_start_date": "2023-09-01T00:00:00.000Z"
          },
          "location": {
            "index": 87.2,
            "region": "South East"
          },
          "time": {
            "index": 92.8
          },
          "features": [
            "Traditional Construction",
            "Suburban Location",
            "Two Storey",
            "Brick Construction",
            "Standard Specifications"
          ],
          "report": {
            "matches": [
              "Building Function: Educational",
              "Construction Process: New Build",
              "Two Storey Design",
              "Regional Location"
            ],
            "differences": [
              "Construction Method: Traditional vs Modern",
              "Location: Suburban vs Urban",
              "Materials: Brick vs Steel Frame",
              "Total Cost: 12% lower"
            ],
            "score_breakdown": {
              "mandatory_match": 1.0,
              "feature_similarity": 0.65,
              "scale_similarity": 0.85,
              "location_similarity": 0.76,
              "overall_score": 0.78
            }
          }
        }
      ]
    }
  ]
}

​

Similarity Scoring Algorithm

​

Mandatory Matching (Weight: 40%)

• Building Function: Must match exactly (e.g., Educational, Residential)
• Construction Process: Must match exactly (e.g., New Build, Refurbishment)
• Projects without mandatory matches are excluded from results

​

Feature Similarity (Weight: 30%)

• Building Characteristics: Sustainable design, construction methods, specifications
• Site Characteristics: Urban/suburban location, access, constraints
• Design Features: Multi-storey, accessibility features, special requirements

​

Scale Similarity (Weight: 20%)

• Cost Comparison: Footprint cost and total cost relative to project scale
• Size Metrics: GIFA, site area, and other dimensional comparisons
• Proportional Analysis: Ratios and per-unit metrics

​

Location & Time Similarity (Weight: 10%)

• Regional Factors: Economic conditions, labor costs, material availability
• Market Timing: Construction market conditions at time of contract
• Geographic Proximity: Generalized location similarity

​

Data Privacy & Anonymization

​

Anonymized Elements

• Organization Identity: Source organization never revealed
• Project Names: All identifying project information removed
• Client Information: No client or stakeholder data included
• Precise Location: Coordinates generalized to protect specific sites

​

Preserved Elements

• Building Characteristics: Function, process, features maintained
• Scale Information: Costs, areas, and dimensions preserved
• Regional Context: Generalized location for market comparison
• Timeline Data: Contract dates for market timing analysis

​

Use Cases

​

Benchmarking

• Compare project costs against similar community projects
• Validate budget estimates using real project data
• Understand cost variations across regions and time periods

​

Risk Assessment

• Identify potential risks based on similar project experiences
• Understand success factors from comparable developments
• Assess project feasibility against similar developments

​

Market Analysis

• Understand current market rates for similar projects
• Analyze trends in construction costs and methods
• Compare regional variations in project delivery

​

Error Responses

{
  "statusCode": 400,
  "message": "Invalid project ID provided.",
  "error": "Bad Request"
}

{
  "statusCode": 403,
  "message": "User does not have permission to perform this action",
  "error": "Forbidden"
}

{
  "statusCode": 404,
  "message": "Project not found or you do not have access to this project.",
  "error": "Not Found"
}

​

Empty Results

{
  "developments": []
}

• Project characteristics are highly unique
• Community data is limited for the project type
• Organization is not connected to relevant communities

​

Rate Limiting

• Rate Limit: 10 requests per minute per user
• Headers: Rate limit information included in response headers
• Retry: Use exponential backoff for rate-limited requests

​

Best Practices

​

Query Optimization

• Ensure project has complete characteristic data for better matching
• Regular project data updates improve matching accuracy
• Consider regional and temporal factors in analysis

​

Data Interpretation

• Use similarity scores as guidance, not absolute measures
• Consider the similarity report for context on matches and differences
• Factor in market conditions and regional variations

​

Community Participation

• Contributing data improves results for all community members
• Regular data synchronisation ensures current community database
• Quality project data leads to better similarity matching

​

Related Endpoints

• Community Sync - Trigger community data synchronisation
• Benchmark Reports - Enhanced with community data
• Project Data - Source project information