# Get the rate card in force

`GET https://evohub.io/api/v1/billing/rate-card`

Part of the [Billing API](https://docs.evohub.io/billing.md) reference · operationId `getRateCard`.

The rate card that prices today's usage: one EHU weight per metric
and the price per EHU at each tier. A metric's charge is
`quantity × ehu_weight` EHU, priced at the organization's tier.

This can differ from `/api/v1/pricing`, which shows the latest
published card — a new price is published ahead of the day it takes
effect.

Requires no scope: any valid key can read it.

## Authorization

Any one of:

- `bearerKey`
- `headerKey`

Where:

- `bearerKey`: HTTP Bearer — An EvoHub API key (`evohub_…`) as a bearer token.
- `headerKey`: API key in the header `X-API-Key` — An EvoHub API key (`evohub_…`).

## Responses

### 200 — The rate card.

Content type: `application/json`

Type: `object`

- `data` (RateCard)
  - `version` (integer)
  - `effective_from` (string (date-time)): When this card starts pricing usage.
  - `usd_per_ehu` (object): The price of one EHU at each tier, in US dollars.
    - `on_demand` (number)
    - `commitment` (number)
    - `prepaid` (number): The price of credit bought in bundles.
  - `metrics` (array of object): One weight per metric, sorted by `metric_key`.
    - `metric_key` (string)
    - `ehu_weight` (number): EHU charged for one unit of the metric.

### 401 — No API key was sent, or it is unknown, revoked or expired (`UNAUTHORIZED`).

Content type: `application/json`

Type: `Error`

- `error` (object, required)
  - `code` (string, required, example `STATEMENT_NOT_FOUND`)
  - `message` (string, required, example `No statement for that period.`)
  - `request_id` (string)

### 429 — Too many requests (`RATE_LIMITED`). Wait for `Retry-After` seconds.

Headers:

- `Retry-After` (integer): Seconds to wait before retrying.

Content type: `application/json`

Type: `Error`

- `error` (object, required)
  - `code` (string, required, example `STATEMENT_NOT_FOUND`)
  - `message` (string, required, example `No statement for that period.`)
  - `request_id` (string)

### 500 — The rate card could not be loaded (`RATE_CARD_FAILED`). Retry later.

Content type: `application/json`

Type: `Error`

- `error` (object, required)
  - `code` (string, required, example `STATEMENT_NOT_FOUND`)
  - `message` (string, required, example `No statement for that period.`)
  - `request_id` (string)

## Example request

```bash
curl -X GET 'https://evohub.io/api/v1/billing/rate-card' \
  -H 'Authorization: Bearer <TOKEN>'
```