# Vacuum Technology API
> Vacuum-technology maths as an API, computed locally and deterministically — the pump-down, boiling and pressure numbers a lab tech, process engineer or vacuum hobbyist works to. The pumpdown endpoint gives the ideal time to evacuate a chamber, t = (volume ÷ pump speed) × ln(start ÷ target pressure) — a 10-litre chamber on a 5 L/s pump drops from 1000 to 1 mbar in about 14 seconds in theory, though outgassing and falling pump speed stretch the real low-pressure stage. The boiling-point endpoint gives the temperature water boils at under reduced pressure from the Antoine equation: about 100 °C at sea level, but only ~52 °C at 100 mbar and ~46 °C at 100 mbar — the physics behind vacuum degassing, freeze-drying and high-altitude cooking. The level endpoint converts a pressure across the common vacuum units (mbar, Torr/mmHg, Pa, kPa, inHg, atm, psi), reports the percent vacuum relative to atmosphere, and names the regime — rough, medium, high or ultra-high vacuum — so you know which pump and gauge the job needs. Everything is computed locally and deterministically, so it is instant and private. Ideal for vacuum-lab and process apps, pump-sizing and degassing tools, semiconductor and coating calculators, and physics teaching. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 compute endpoints. Ideal estimates — real systems are slowed by outgassing and leaks.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/vacuum-api/..."
```

## Pricing
- **Free** (Free) — 470 calls/Mo, 2 req/s
- **Starter** ($6/Mo) — 12,600 calls/Mo, 6 req/s
- **Pro** ($18/Mo) — 80,000 calls/Mo, 15 req/s
- **Mega** ($53/Mo) — 260,000 calls/Mo, 36 req/s

## Endpoints

### Vacuum

#### `GET /v1/boiling-point` — Water boiling point at pressure

**Parameters:**
- `pressure` (query, required, string) — Pressure value Example: `100`
- `unit` (query, optional, string) — mbar | mmhg/torr | pa | kpa (default mbar) Example: `mbar`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/vacuum-api/v1/boiling-point?pressure=100&unit=mbar"
```

**Response:**
```json
{
    "data": {
        "note": "Water boils when its vapour pressure equals the surrounding pressure — drop the pressure and it boils cooler (Antoine equation): about 100 °C at sea level, but only ~52 °C at 100 mbar and ~7 °C near 10 mbar. This is why vacuum degassing, freeze-drying and high-altitude cooking work. Valid roughly 6–1013 mbar.",
        "inputs": {
            "unit": "mbar",
            "pressure": 100
        },
        "pressure_mmhg": 75.01,
        "boiling_point_c": 45.9,
        "boiling_point_f": 114.6
    },
    "meta": {
        "timestamp": "2026-06-06T23:54:02.565Z",
        "request_id": "4a4a06b5-5aa0-41bb-8c66-c6fe9da52b7e"
    },
    "status": "ok",
    "message": "Boiling point",
    "success": true
}
```

#### `GET /v1/level` — Pressure, % vacuum and regime

**Parameters:**
- `pressure` (query, required, string) — Pressure value Example: `1`
- `unit` (query, optional, string) — mbar | mmhg/torr | pa | kpa | inhg | atm | psi (default mbar) Example: `mbar`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/vacuum-api/v1/level?pressure=1&unit=mbar"
```

**Response:**
```json
{
    "data": {
        "inhg": 0.02953,
        "mbar": 1,
        "note": "Pressure across the common vacuum units, with percent vacuum relative to a 1013 mbar atmosphere and the regime: rough vacuum (1013–1 mbar), medium (1–10⁻³), high (10⁻³–10⁻⁷) and ultra-high below that. Different pumps and gauges work in different regimes — a roughing pump can't reach high vacuum.",
        "inputs": {
            "unit": "mbar",
            "pressure": 1
        },
        "pascal": 100,
        "regime": "rough (low) vacuum",
        "torr_mmhg": 0.750062,
        "percent_vacuum": 99.9013
    },
    "meta": {
        "timestamp": "2026-06-06T23:54:02.661Z",
        "request_id": "ae4bc0bd-5bc0-4263-880f-84f2df02d7d4"
    },
    "status": "ok",
    "message": "Vacuum level",
    "success": true
}
```

#### `GET /v1/pumpdown` — Chamber pump-down time

**Parameters:**
- `volume_l` (query, required, string) — Chamber volume in litres Example: `10`
- `pump_speed_l_s` (query, required, string) — Pump speed in L/s Example: `5`
- `start_pressure` (query, required, string) — Starting pressure Example: `1000`
- `target_pressure` (query, required, string) — Target pressure (same unit) Example: `1`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/vacuum-api/v1/pumpdown?volume_l=10&pump_speed_l_s=5&start_pressure=1000&target_pressure=1"
```

**Response:**
```json
{
    "data": {
        "note": "Ideal pump-down time = (chamber volume ÷ pump speed) × ln(start ÷ target pressure) — pressures in any consistent unit (the ratio is what counts). Real systems take longer: outgassing, virtual leaks and falling effective pump speed at low pressure all slow the last decades down. Use it for the rough vacuum stage.",
        "inputs": {
            "volume_l": 10,
            "pump_speed_l_s": 5,
            "start_pressure": 1000,
            "target_pressure": 1
        },
        "pumpdown_minutes": 0.23,
        "pumpdown_seconds": 13.8
    },
    "meta": {
        "timestamp": "2026-06-06T23:54:02.728Z",
        "request_id": "935d3bc2-89a1-4f93-8f4d-88bce7955a76"
    },
    "status": "ok",
    "message": "Pump-down time",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/vacuum-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "notes": "Pump-down t=(V/S)·ln(P1/P2); water boiling via Antoine (6–1013 mbar); regimes rough/medium/high/UHV. Units mbar, torr/mmHg, Pa, kPa, inHg, atm, psi. Ideal estimates — outgassing and leaks slow real systems.",
        "service": "vacuum-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/level": "Pressure across units, percent vacuum and the vacuum regime.",
            "GET /v1/pumpdown": "Ideal pump-down time t = (V/S)·ln(P1/P2).",
            "GET /v1/boiling-point": "Water boiling temperature at a pressure (Antoine equation)."
        },
        "description": "Vacuum-technology maths: chamber pump-down time, the boiling point of water under reduced pressure, and pressure conversion with the vacuum regime."
    },
    "meta": {
        "timestamp": "2026-06-06T23:54:02.790Z",
        "request_id": "7feeeb09-8426-456e-a3db-8fb41285d240"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/vacuum-api
OpenAPI spec: https://www.oanor.com/api/vacuum-api/openapi.json