Spec

Code snippets

curl "https://api.oanor.com/valveflow-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/valveflow-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/valveflow-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/valveflow-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "notes": "Flow in m³/h, pressure drop in bar, specific gravity relative to water. Turbulent, non-choked liquid flow; flashing, cavitation and gas/steam sizing are not covered.",
        "service": "valveflow-api",
        "formulae": {
            "sizing": "Q = Kv·√(ΔP/SG),  Kv = Q/√(ΔP/SG),  ΔP = SG·(Q/Kv)²",
            "opening": "linear = Kv/Kvs,  equal-% = 1 + ln(Kv/Kvs)/ln(R)",
            "conversion": "Cv = 1.156·Kv,  Av = 2.4e-5·Cv"
        },
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/liquid": "Liquid valve sizing: solve Kv, flow or pressure drop from the other two.",
            "GET /v1/convert": "Convert between the Cv, Kv and Av flow coefficients.",
            "GET /v1/opening": "Required valve opening (%) for an operating Kv against the rated Kvs."
        },
        "description": "Control-valve flow-coefficient calculator: liquid Cv/Kv sizing, Cv↔Kv↔Av conversion, and required valve opening for linear and equal-percentage trims."
    },
    "meta": {
        "timestamp": "2026-06-04T18:38:26.122Z",
        "request_id": "fbf75516-5e87-4e66-a4d0-06a292d5ab8a"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}