Skip to content

Open API v1 · CC BY 4.0

Build on the data. No key, no contract.

Everything the site shows about species, scores, climate zones and modelled service life is available as JSON. Free, unauthenticated, CORS-open, and licensed CC BY 4.0 so BIM tools, CAD plug-ins, research scripts and AI agents can use it directly.

curl https://woodintel.io/api/public/v1/scores?slug=accoya

Every response is wrapped in an envelope carrying the API version, licence, attribution string, generation timestamp and the caveats that must travel with the numbers.

  • GET /api/public/v1/

    Service index

    Lists every endpoint, the licence and the republication terms.

  • GET /api/public/v1/species

    Species properties

    Density at 12 % MC, EN 350 durability class, EN 335 use classes, EN 13501-1 reaction to fire, EN 1995-1-2 charring rate and EN 16449 biogenic carbon — each with the method text that produced it.

    • ?slug — return a single species
  • GET /api/public/v1/scores

    WoodIntel Score

    Six sub-scores (durability, carbon, maintenance, fire, circularity, sourcing) plus the unweighted composite, with the formula behind each value.

    • ?slug — return a single species
  • GET /api/public/v1/climate-zones

    Climate zones

    Station coordinates, Köppen class, distance to open water, and whether the zone is covered by the index.

  • GET /api/public/v1/predictions

    Modelled predictions

    The full WoodIntel Index matrix: P10/P50/P90 service life and maintenance interval per species, zone, orientation and treatment state.

    • ?species
    • ?climate
    • ?orientation
    • ?treated (true|false)
    • ?limit (max 500)
  • GET /api/public/v1/evidence

    Evidence Engine

    The living meta-analysis (WI-EV): every tracked claim with its Evidence Score, consensus share, confidence band and version. A single claim returns the indexed studies with stance and grade, the contradictions, the research timeline and the full public revision history.

    • ?claim — return one claim with studies, contradictions, timeline and revisions
  • GET /api/public/v1/research-agenda

    Research Agenda

    The open gaps in the wood record (WI-GAP): every tracked claim scored 0–100 on thin evidence, unresolved dissent, ageing studies and low evidence score, with the per-factor breakdown and the open question that would close the gap.

Terms

Use is free with attribution: “WoodIntel — woodintel.io, CC BY 4.0”. Service lives are modelled estimates from method WI-SL, not measured lifetimes, and must be labelled as modelled when republished. Scores are comparative and are not recommendations.

The API is read-only and serves no personal data. It carries no uptime guarantee. Cache responses for at least five minutes; the underlying index is regenerated, not streamed. If you need a bulk export instead, the datasets on the data page are the same numbers as CSV and JSON.