---
title: "Azure spot eviction-rate history (28-day buckets, sampled daily)."
method: GET
path: "/v1/azure/eviction"
tags: ["azure"]
---

# Azure spot eviction-rate history (28-day buckets, sampled daily).

`GET /v1/azure/eviction`

## Request

- Base URL: `https://cloud.trycorpus.ai`
- URL: `https://cloud.trycorpus.ai/v1/azure/eviction`
- Auth: one of:
  - API key in header `PAYMENT-SIGNATURE`
  - API key in header `Authorization`
  - API key in header `X-Api-Key`

Daily samples of the eviction-rate bucket Azure reports per SKU (`0-5`, `5-10`, `10-15`, `15-20`, `20+` percent over the trailing 28 days). Collected daily since 2026-09-05; there is no history before the first sample.

## Query parameters

- `region` 'us-east' | 'us-west-2' | 'eu-west', required
- `sku` string
- `from` string, date
- `to` string, date

## Response `200`

Eviction samples.

- EvictionList
  - `region` string
  - `count` integer
  - `samples` object[]
    - `date` string, date: Sample day.
    - `sku` string
    - `bucket` string: Eviction-rate bucket in percent over the trailing 28 days: `0-5`, `5-10`, `10-15`, `15-20`, `20+`.

## Other responses

- `400`: Invalid or missing parameter.
- `402`: Payment required. The x402 v2 payment requirements are in the PAYMENT-REQUIRED header (base64 JSON) and repeated as the JSON body: `accepts[]` lists every offer (USDC on 13 networks: eip155:8453, eip155:143, eip155:1, eip155:43114, eip155:42161, eip155:10, eip155:137, eip155:130, eip155:146, eip155:480, eip155:1329, eip155:999, eip155:5042) with amount and payTo address. Circle Gateway offers cover every listed network; a Coinbase-facilitated offer covers Base. The same response carries an MPP challenge (WWW-Authenticate: Payment, USDC on Tempo). Retry with a PAYMENT-SIGNATURE header or an MPP credential, or let an x402 or MPP client (for example `circle services pay` or `mppx`) handle it; a prepaid key in X-Api-Key is charged instead of a 402.
- `404`: Unknown provider, region or instance type.
- `503`: The store is still warming up after a restart; retry in a minute. No payment is taken.

---

[API](https://skmtc.dev/trycorpus/apis/corpusai-cloud-pricing-api.md) · [All operations](https://skmtc.dev/trycorpus/apis/corpusai-cloud-pricing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trycorpus/apis/corpusai-cloud-pricing-api/revisions/cb0754f4d151?raw)
