# Get Started (API)

- Canonical URL: https://docs.fairvisor.com/docs/reference/get-started-api/
- Section: docs
- Last updated: n/a
> Fast path: first decision request, first reject, first metric.


## 1) Send your first decision request

```bash
curl -i -X POST http://localhost:8080/v1/decision \
  -H 'X-Original-Method: GET' \
  -H 'X-Original-URI: /api/health'
```

Expect `200` when request is allowed.

## 2) Trigger a reject intentionally

Use a low-limit token bucket policy and send repeated requests until you get `429` with:

- `X-Fairvisor-Reason`
- `Retry-After`
- `RateLimit-*`

## 3) Verify readiness and metrics

```bash
curl -sS http://localhost:8080/readyz
curl -sS http://localhost:8080/metrics | rg fairvisor_decisions_total
```

## Next

- [Core Reference](/docs/reference/core-reference/)
- [Decision Tracing](/docs/reference/decision-tracing/)
- [How-to Library](/docs/reference/how-to-library/)