# Add a rate to the organization's price list

Source: <https://everruns.com/docs/api/operations/create_cost_rate/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Operations & billing](https://everruns.com/docs/api/groups/operations-billing/)/Add a rate to the organization's price list

# Add a rate to the organization's price list

Preview

Add a rate to the organization’s price list. A rate is a fixed price per unit or a multiple of the list price; rates are never edited, a change is a new rate from a later date.

Public APIEverruns Cloud and self-hosted Platform

POST`/v1/cost-rates`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Request Bodyrequired

Media typeapplication/json

Add a rate to the org’s price list. Rates are never edited: a change is a new rate from a later date.

object

**effective_from**

When it starts; now when absent.

string | null format: date-time

**list_price_multiplier**

Multiple of the provider’s or catalog price. Model tokens only.

number | null format: double

**match**

Which usage it applies to (see `CostRate.match`).

object | null

**meter**

required

`model.tokens` or `sandbox.time`.

string

**unit_price_usd**

Fixed USD per million tokens (model tokens) or per hour (sandboxes).

number | null format: double

### Example generated

```json
{
  "effective_from": "2026-04-15T12:00:00Z",
  "list_price_multiplier": 1,
  "match": "example",
  "meter": "example",
  "unit_price_usd": 1
}
```

## Responses

201Created

### 201

Created

Media typeapplication/json

One row of the org’s price list.

object

**created_at**

required

When the rate was added.

string format: date-time

**effective_from**

required

When the rate starts to apply.

string format: date-time

**id**

required

Rate id (`rate_...`).

string

**list_price_multiplier**

Multiple of the provider’s or catalog’s price (0.8 is a 20% discount, 0 counts usage at no cost).

number | null format: double

**match**

required

Which usage it applies to. Model tokens: `provider`, `model`, `source` (`managed` or `own_keys`). Sandbox time: `provider`, `size`. Empty applies to the whole meter.

object

**meter**

required

What it prices: `model.tokens` or `sandbox.time`.

string

**reason**

Why the rate was added: the change reason given with it.

string | null

**retired**

required

This row ends the rates it matches from `effective_from`.

boolean

**unit**

required

Unit of `unit_price_usd`: `1m_tokens` or `hour`.

string

**unit_price_usd**

Fixed price per unit, in USD.

number | null format: double

### Example generated

```json
{
  "created_at": "2026-04-15T12:00:00Z",
  "effective_from": "2026-04-15T12:00:00Z",
  "id": "example",
  "list_price_multiplier": 1,
  "match": {},
  "meter": "example",
  "reason": "example",
  "retired": true,
  "unit": "example",
  "unit_price_usd": 1
}
```

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/cost-rates';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"effective_from":"2026-04-15T12:00:00Z","list_price_multiplier":1,"match":"example","meter":"example","unit_price_usd":1}'
};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request POST \
  --url https://app.everruns.com/api/v1/cost-rates \
  --header 'Content-Type: application/json' \
  --data '{ "effective_from": "2026-04-15T12:00:00Z", "list_price_multiplier": 1, "match": "example", "meter": "example", "unit_price_usd": 1 }'
```

Additional language examples require JavaScript. The default request example is available above.

201

201 · Created

```json
{
  "created_at": "2026-10-12T09:00:00Z",
  "effective_from": "2026-10-12T09:00:00Z",
  "id": "string",
  "match": {},
  "meter": "string",
  "retired": true,
  "unit": "string"
}
```

## Matching endpoints