# ADA Ramp API
> ADA wheelchair-ramp maths as an API, computed locally and deterministically — the run, landing and slope numbers a builder or accessibility planner sizes a ramp by. The rule the ADA fixes is 1 inch of rise per 12 of run, a maximum 8.33 % slope, so the ramp endpoint turns a rise into the ramp: run = rise × 12 (or × 16 / × 20 for a gentler grade if you have the room), plus the level landings the code requires — a 5-foot landing top and bottom and another between runs whenever the rise exceeds 30 inches — and the total length end to end, so a 24-inch rise needs a 24-foot run and 34 feet overall, while a 36-inch rise breaks into two runs with an intermediate landing for 51 feet. The fit endpoint answers the real-world question: does a ramp for this rise fit the run you have? It returns the minimum run an ADA 1:12 ramp needs, whether your space is enough, and the slope you would actually get if you forced it in — flagging when that exceeds 8.33 % and you need a switchback or a lower rise. Everything is computed locally and deterministically, so it is instant and private. Ideal for construction, accessibility, home-modification and contractor app developers, ramp-estimator and code-check tools, and building software. Pure local computation — no key, no third-party service, instant. Confirm against current ADA and local code. Live, nothing stored. 2 compute endpoints.

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

## Pricing
- **Free** (Free) — 6,500 calls/Mo, 2 req/s
- **Starter** ($5/Mo) — 52,400 calls/Mo, 6 req/s
- **Pro** ($12/Mo) — 217,500 calls/Mo, 15 req/s
- **Mega** ($39/Mo) — 1,278,000 calls/Mo, 40 req/s

## Endpoints

### Ramp

#### `GET /v1/fit` — Does it fit the run?

**Parameters:**
- `rise` (query, required, string) — Vertical rise Example: `10`
- `available_run` (query, required, string) — Available horizontal run Example: `120`
- `unit` (query, optional, string) — in or ft (default in) Example: `in`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/adaramp-api/v1/fit?rise=10&available_run=120&unit=in"
```

#### `GET /v1/ramp` — Ramp run + landings

**Parameters:**
- `rise` (query, required, string) — Vertical rise Example: `24`
- `unit` (query, optional, string) — in or ft (default in) Example: `in`
- `slope_denominator` (query, optional, string) — Slope 1:N (default 12 = ADA max) Example: `12`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/adaramp-api/v1/ramp?rise=24&unit=in&slope_denominator=12"
```

### Meta

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

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


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