# Mobile Crane Lift API
> Mobile-crane lift-planning maths as an API, computed locally and deterministically — the load-moment, tipping-capacity and outrigger-pad numbers a crane operator, lift planner or rigging engineer checks a pick with. The load-moment endpoint gives the load × its working radius (the horizontal distance from the slew centre to the hook), the single figure a crane's rated-capacity limiter watches: a 5-tonne load at 8 m is a 40 tonne-metre moment, the same as 10 tonnes at 4 m, which is why chart capacity falls steeply as the boom luffs out — moment, not weight, tips the crane. The capacity endpoint gives a simplified tipping balance about the fulcrum: the load that just tips = counterweight × its radius ÷ the load radius, and the rated safe load is a stability fraction of that (~75 % on outriggers, ~66 % on crawlers per the standards) — a teaching/sanity figure that ignores the boom and superstructure, never a substitute for the load chart. The outrigger-pad endpoint sizes the float: required pad area = the outrigger leg load ÷ the soil's allowable bearing pressure (and the side of a square mat), since overloading weak ground is a leading cause of overturns — a 30-tonne leg on 200 kPa wants about a 1.2 m square mat. Everything is computed locally and deterministically, so it is instant and private. Ideal for lift-planning and rigging tools, construction and crane-operations apps, and site-safety utilities. Pure local computation — no key, no third-party service, instant. Simplified — always use the manufacturer load chart. 3 compute endpoints. For sling and WLL loads use a rigging API.

## 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/crane-api/..."
```

## Pricing
- **Free** (Free) — 4,550 calls/Mo, 2 req/s
- **Starter** ($13/Mo) — 47,500 calls/Mo, 6 req/s
- **Pro** ($42/Mo) — 203,000 calls/Mo, 15 req/s
- **Mega** ($128/Mo) — 1,095,000 calls/Mo, 40 req/s

## Endpoints

### Crane

#### `GET /v1/capacity` — Tipping-limited safe load

**Parameters:**
- `counterweight_tonnes` (query, required, string) — Counterweight (tonnes) Example: `20`
- `counterweight_radius_m` (query, required, string) — Counterweight radius (m) Example: `3`
- `load_radius_m` (query, required, string) — Load radius (m) Example: `8`
- `stability_factor` (query, optional, string) — Stability factor (default 0.75) Example: `0.75`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/crane-api/v1/capacity?counterweight_tonnes=20&counterweight_radius_m=3&load_radius_m=8&stability_factor=0.75"
```

#### `GET /v1/load-moment` — Load moment from load and radius

**Parameters:**
- `load_tonnes` (query, required, string) — Load (tonnes) Example: `5`
- `radius_m` (query, required, string) — Working radius (m) Example: `8`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/crane-api/v1/load-moment?load_tonnes=5&radius_m=8"
```

#### `GET /v1/outrigger-pad` — Outrigger pad area from bearing

**Parameters:**
- `outrigger_load_tonnes` (query, required, string) — Outrigger leg load (tonnes) Example: `30`
- `allowable_bearing_kpa` (query, required, string) — Allowable ground bearing (kPa) Example: `200`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/crane-api/v1/outrigger-pad?outrigger_load_tonnes=30&allowable_bearing_kpa=200"
```

### Meta

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

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


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