Skip to main content
GET
/
benchmark
/
project
/
{projectId}
Get a benchmark report using the standard model from project Id
curl --request GET \
  --url https://api.n-3.co.uk/benchmark/project/{projectId} \
  --header 'x-api-key: <api-key>'
{
  "totals": 2571000,
  "external_works_variation": 100000,
  "total_including_external_works": 2571000,
  "total_adjusted_value": 2991359,
  "adjusted_cost_per_m2": 1994,
  "lower_limit": 1595,
  "upper_limit": 2592,
  "_meta": {
    "adjustment_percentage": 0.35,
    "external_works_percentage": 0.25,
    "strength": 75,
    "profiled_strength": 2.5,
    "location": {
      "county": "London",
      "index": 100
    }
  }
}

​
Overview

Retrieves existing benchmark reports and cost predictions for a specific project. This endpoint provides access to previously generated benchmarks, including hybrid development support for composite projects.

​
Response Features

​
Cost Predictions

  • Statistical cost forecasts based on similar projects
  • Confidence intervals showing prediction uncertainty
  • Historical trend analysis and market positioning
  • Element-level cost breakdowns

​
Comparison Analysis

  • Similar project matches with quality grades
  • Source health ratings (20-100% reliability)
  • Similarity scores and ranking factors
  • Geographic and temporal context

​
Quality Indicators

  • Data completeness assessments
  • Statistical validity checks
  • Benchmark reliability scores
  • Confidence level indicators

​
Multi-Development Support

For composite projects, the endpoint supports:
  • Hybrid View - Toggle between composite and individual developments
  • Development-Specific Data - Separate predictions for each building type
  • Aggregate Analysis - Combined project-level insights
  • Cross-Development Comparison - Performance across different building types

​
Usage Examples

​
Standard Project Request

GET /benchmark/project/12345

​
Hybrid Development Request

GET /benchmark/project/12345?hybridSupport=true&development=dev1

​
Response Structure

Returns comprehensive benchmark data: 
{
  "predictions": {
    "costForecast": {...},
    "confidenceInterval": {...},
    "qualityRating": "Strong"
  },
  "comparisons": {
    "similarProjects": [...],
    "qualityGrades": [...],
    "sourceHealth": {...}
  },
  "metadata": {
    "generatedAt": "...",
    "modelVersion": "...",
    "dataSource": "..."
  }
}

​
Error Handling

  • 404 - Project not found or no benchmark data available
  • 400 - Invalid project ID or request parameters
  • 500 - Server error during benchmark retrieval

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
projectId
integer<int64>
required

Response

200 - application/json
​
totals
number
required

Total cost (sum)

Example:

2571000

​
external_works_variation
number
required

External works variation

Example:

100000

​
total_including_external_works
number
required

Total including external works

Example:

2571000

​
total_adjusted_value
number
required

Total adjusted value

Example:

2991359

​
adjusted_cost_per_m2
number
required

Adjusted cost per m2 (GIFA)

Example:

1994

​
lower_limit
number
required

Lower limit for adjusted cost per m2

Example:

1595

​
upper_limit
number
required

Upper limit for adjusted cost per m2

Example:

2592

​
_meta
object
required