Skip to main content
REST API  v1

NOVTRIQ Engineering API

A REST API giving programmatic access to the full suite of NOVTRIQ engineering calculation tools — PUE, EPBD, NIS2, thermal analysis, carbon, structural design, and more.

Base URL: https://api.novtriq.tech/v1 Format: JSON Auth: X-NOVTRIQ-Key

Authentication

All API requests must include your API key in the request header. You can generate and manage keys from your NOVTRIQ dashboard.

Header X-NOVTRIQ-Key: nvq_your_api_key_here
Base URL https://api.novtriq.tech/v1
Content-Type application/json

Endpoints

All tool endpoints accept POST requests with a JSON body. Every response includes a result object, a confidence score, cited references, and actionable recommendations.

POST /tools/pue Power Usage Effectiveness

Request Body

total_power_kwnumber — total facility power (kW)
it_power_kwnumber — IT equipment power (kW)
cost_per_kwhnumber — electricity cost (€/kWh)
facility_typestring — data_center | edge | colocation

Response Fields

result.puenumber — calculated PUE ratio
result.annual_costnumber — projected annual cost (€)
confidencenumber — 0–1 confidence score
references[]array — cited standards & sources
recommendations[]array — optimisation actions
POST /tools/epbd EPBD Compliance Check

Request Body

building_typestring — office | residential | industrial
floor_area_m2number — gross floor area (m²)
heating_systemstring — gas | heat_pump | district
country_codestring — ISO 3166-1 alpha-2 (e.g. DE, FR, RO)

Response Fields

result.ratingstring — EPC class (A–G)
result.compliantboolean — meets EPBD 2024 standard
confidencenumber — 0–1 confidence score
references[]array — applicable EU directives
recommendations[]array — retrofit actions
POST /tools/nis2 NIS2 Readiness Assessment

Request Body

entity_typestring — essential | important
sectorstring — NIS2 Annex I/II sector name
employee_countnumber — total headcount
current_controls[]array — list of implemented controls

Response Fields

result.scorenumber — readiness score (0–100)
result.gaps[]array — identified compliance gaps
confidencenumber — 0–1 confidence score
references[]array — NIS2 directive articles
recommendations[]array — prioritised remediation steps
POST /tools/thermal Thermal Load Estimation

Request Body

it_load_kwnumber — total IT load (kW)
cooling_typestring — air | liquid | hybrid | free_cooling
ambient_temp_cnumber — design ambient temperature (°C)
redundancy_tierstring — N | N+1 | 2N

Response Fields

result.cooling_kwnumber — required cooling capacity (kW)
result.copnumber — coefficient of performance
confidencenumber — 0–1 confidence score
references[]array — ASHRAE / EN standards cited
recommendations[]array — efficiency improvements

Code Example

Calculate PUE for a 500 kW facility using curl.

bash — curl
curl -X POST https://api.novtriq.tech/v1/tools/pue \
  -H "X-NOVTRIQ-Key: nvq_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "total_power_kw": 500,
    "it_power_kw":    350,
    "cost_per_kwh":  0.18,
    "facility_type": "data_center"
  '}

# Example response
{
  "result": {
    "pue": 1.43,
    "annual_cost_eur": 789840
  },
  "confidence": 0.97,
  "references": ["EN 50600-4-2", "The Green Grid WP#49"],
  "recommendations": [
    "Consider hot/cold aisle containment to reduce PUE to ~1.25",
    "UPS efficiency upgrade could save ~€32,000/yr"
  ]
}

Rate Limits

Rate limits apply per API key. Exceeding limits returns HTTP 429 Too Many Requests with a Retry-After header.

Plan Requests / Hour Requests / Month MCP Access Support
Free 10 100 No Community
Developer 200 1,000 Yes Email
Enterprise Unlimited Unlimited Yes SLA + Dedicated

AI Integration via MCP

Prefer calling NOVTRIQ tools from Claude, Cursor, or another AI assistant? Use the MCP server for direct AI-to-tool integration without any custom code.

NOVTRIQ MCP Server — Connect Claude Desktop, Cursor, Continue.dev, or any MCP-compatible client directly to all eight engineering tools. No REST calls required.

Start building with NOVTRIQ

Get your API key and integrate engineering calculations into your workflow in minutes.

Get API Key