# End a rate from a date

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

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Operations & billing](https://everruns.com/docs/api/groups/operations-billing/)/End a rate from a date

# End a rate from a date

Preview

End a rate from a date. Past costs keep the rate they used; usage after the date falls back to the provider’s or catalog price.

Public APIEverruns Cloud and self-hosted Platform

POST`/v1/cost-rates/{rate_id}/retire`

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

## Parameters

### Path Parameters

**rate_id**

required

string

Prefixed public identifier

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

404Rate not found

### 404

Rate not found

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/cost-rates/example/retire';
const options = {method: 'POST'};


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/example/retire
```

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

201404

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

404 · Rate not found

No response body example is declared for this status.

## Matching endpoints