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

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

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

### Meta

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

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


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