> ## Documentation Index
> Fetch the complete documentation index at: https://hevninc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Public API

> Unauthenticated REST endpoints used by HEVN CLI PublicApi.

`PublicApi` sends only `Accept: application/json`.

## FX rate

```http theme={null}
GET /utils/rates/{currency}
```

CLI surface:

```bash theme={null}
hevn rate EUR
hevn rate --currency AED --yaml
```

Path parameters:

| Parameter  | Type   | Purpose                             |
| ---------- | ------ | ----------------------------------- |
| `currency` | string | Currency code to price against USD. |

Example response fields consumed by the CLI:

```json theme={null}
{
  "usdRate": "1.08",
  "bankTransfer": "1.08",
  "card": "1.10"
}
```

## Public invoice

```http theme={null}
GET /public/invoices/{invoice_id}
```

CLI surface:

```bash theme={null}
hevn invoice get <invoice-id> --public
```

Path parameters:

| Parameter    | Type   | Purpose            |
| ------------ | ------ | ------------------ |
| `invoice_id` | string | Public invoice id. |

The CLI renders the returned invoice with the same invoice formatter used for authenticated invoice reads.