---
title: "List spend rule history"
method: GET
path: "/spend-rules/{id}/history"
tags: ["Gateway"]
---

# List spend rule history

`GET /spend-rules/{id}/history`

## Request

- Base URL: `https://api.phaseo.app/v1`
- URL: `https://api.phaseo.app/v1/spend-rules/{id}/history`
- Auth: HTTP bearer

Lists the alerts and block events the rule has queued, newest first, with delivery counts, and its most recent period records.

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

Spend rule history

- SpendRuleHistoryResponse
  - `data` SpendRuleHistory, required: Events newest first, with has_more for the next page, and the rule's 12 most recent period records.
    - `events` object[], required
      - `id` string, uuid, required
      - `kind` 'spend_alert' | 'spend_blocked', required
      - `created_at` string, date-time, required
      - `title` string, nullable
      - `message` string, nullable
      - `state` string, nullable
      - `threshold_percent` integer, nullable
      - `thresholds_crossed` integer[], nullable
      - `threshold_amount_nanos` integer, nullable
      - `threshold_amount_usd` number, nullable
      - `value_nanos` integer, nullable
      - `value_usd` number, nullable
      - `base_nanos` integer, nullable
      - `base_usd` number, nullable
      - `percent` number, nullable
      - `period` object, nullable
      - `deliveries` object, required: Delivery attempts by status.
        - `sent` integer, required
        - `failed` integer, required
        - `pending` integer, required
    - `has_more` boolean, required
    - `periods` object[], required
      - `period_start` string, date-time, nullable, required
      - `period_end` string, date-time, nullable, required
      - `highest_percent_fired` integer, nullable, required
      - `amount_fired_at` string, date-time, nullable, required
      - `last_fired_at` string, date-time, nullable, required
      - `fire_count` integer, required
      - `last_value_nanos` integer, nullable, required
      - `last_value_usd` number, nullable, required
      - `last_base_nanos` integer, nullable, required
      - `last_base_usd` number, nullable, required

## Other responses

- `default`: Request failed

## Changes

- **2026-10-27** `58847d40a023`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/changes/spend-rules/:id/history/get.md)

---

[API](https://skmtc.dev/phaseo/apis/phaseo-gateway-api.md) - [All operations](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/phaseo/apis/phaseo-gateway-api/revisions/5ca9bb220d25?raw)