> ## Documentation Index
> Fetch the complete documentation index at: https://docs.n-3.co.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a benchmark report using the standard model from project Id

## 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

```bash theme={null}
GET /benchmark/project/12345
```

### Hybrid Development Request

```bash theme={null}
GET /benchmark/project/12345?hybridSupport=true&development=dev1
```

## Response Structure

Returns comprehensive benchmark data:

```json theme={null}
{
  "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

## Related Endpoints

* **[Create Benchmark](/api-reference/benchmark/create-a-benchmark-report-using-the-standard-model)** - Generate new predictions
* **[Get Similar Projects](/api-reference/benchmark/get-the-three-closest-similar-projects)** - Find comparable projects
* **[Find Snapshots](/api-reference/benchmark/find-benchmark-snapshots-for-the-project)** - Access saved benchmarks


## OpenAPI

````yaml get /benchmark/project/{projectId}
openapi: 3.0.0
info:
  title: Naismith Analytics API
  description: The N3 API
  version: '0.1'
  contact: {}
servers: []
security: []
tags: []
paths:
  /benchmark/project/{projectId}:
    get:
      tags:
        - Benchmark
      summary: Get a benchmark report using the standard model from project Id
      operationId: getFromProjectId
      parameters:
        - name: projectId
          required: true
          in: path
          schema:
            format: int64
            type: integer
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BenchmarkDto'
      security:
        - x-api-key: []
        - bearer: []
components:
  schemas:
    BenchmarkDto:
      type: object
      properties:
        totals:
          type: number
          description: Total cost (sum)
          example: 2571000
        external_works_variation:
          type: number
          description: External works variation
          example: 100000
        total_including_external_works:
          type: number
          description: Total including external works
          example: 2571000
        total_adjusted_value:
          type: number
          description: Total adjusted value
          example: 2991359
        adjusted_cost_per_m2:
          type: number
          description: Adjusted cost per m2 (GIFA)
          example: 1994
        lower_limit:
          type: number
          description: Lower limit for adjusted cost per m2
          example: 1595
        upper_limit:
          type: number
          description: Upper limit for adjusted cost per m2
          example: 2592
        _meta:
          $ref: '#/components/schemas/BenchmarkMetaDto'
      required:
        - totals
        - external_works_variation
        - total_including_external_works
        - total_adjusted_value
        - adjusted_cost_per_m2
        - lower_limit
        - upper_limit
        - _meta
    BenchmarkMetaDto:
      type: object
      properties:
        adjustment_percentage:
          type: number
          description: Percentage adjustment from adjustments
          example: 0.35
        external_works_percentage:
          type: number
          description: Percentage adjustment from external works
          example: 0.25
        strength:
          type: number
          description: >-
            Strength of the benchmark is based on the number of factors used in
            the calculation
          example: 75
        profiled_strength:
          type: number
          description: >-
            The weight of the profiled factors added in the benchmark
            calculation
          example: 2.5
        location:
          description: The identified location used for calculations
          allOf:
            - $ref: '#/components/schemas/BenchmarkLocationMetaDto'
      required:
        - adjustment_percentage
        - external_works_percentage
        - strength
        - profiled_strength
        - location
    BenchmarkLocationMetaDto:
      type: object
      properties:
        county:
          type: string
          description: County name
          example: London
        index:
          type: number
          description: Location index
          example: 100
      required:
        - county
        - index
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````