# List the organization's price list, history included

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

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Operations & billing](https://everruns.com/docs/api/groups/operations-billing/)/List the organization's price list, history included

# List the organization's price list, history included

Preview

Operate durable execution, schedules, sandbox infrastructure, budgets, payments and audit logs.

Public APIEverruns Cloud and self-hosted Platform

GET`/v1/cost-rates`

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

## Responses

200Success

### 200

Success

Media typeapplication/json

Array\<object>

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: 'GET'};


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

Request

```sh
curl --request GET \
  --url https://app.everruns.com/api/v1/cost-rates
```

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

200

200 · Success

```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