---
title: "List what a billing ceiling stopped"
method: GET
path: "/v1/users/me/stops"
tags: ["Users"]
---

# List what a billing ceiling stopped

`GET /v1/users/me/stops`

## Request

- Base URL: `https://api.naturali.ai`
- URL: `https://api.naturali.ai/v1/users/me/stops`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.naturali.ai/authorize`, token URL `https://api.naturali.ai/token`, scopes: `mcp:access`)

Schedule triggers, eval runs, orchestration runs and workflow tasks the platform stopped on this account's projects because the credit balance went below zero or a Free plan's runs ran out, and that have not been restored or dismissed yet. Newest first.

`blocked_by` names the ceiling still closed: while it is set, nothing can be restored. Top up for `debt`; upgrade or wait for the month to turn for `run_allowance`. A `marketplace_fee` stop, for work naming a priced installed listing, is restored only while the paid balance is positive. A project-confined key sees its own project's stops only.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

A page of stops still listed.

- SpendStopPage
  - `data` SpendStop[], required
    - `id` string, required
    - `project_id` string, required
    - `kind` 'schedule_trigger' | 'eval_run' | 'orchestration_run' | 'workflow_task' | 'playbook_case', required: What was stopped: a schedule trigger is disabled, an eval run cancelled, an orchestration run, a workflow task's automation or a playbook case's cascade paused.
    - `resource_id` string, required: The stopped trigger, eval run, orchestration run, task or playbook case.
    - `reason` 'debt' | 'run_allowance' | 'marketplace_fee', required: The ceiling that stopped it: a credit balance below zero, a Free plan's runs for the month used up, or marketplace fees beyond purchased credit (`paid_balance_usd` below zero).
    - `restorable` boolean, required: False for a cancelled eval run, which can only be dismissed.
    - `stopped_at` string, date-time, required
    - `resolution` 'restored' | 'dismissed', nullable, required
    - `resolved_at` string, date-time, nullable, required
  - `blocked_by` 'debt' | 'run_allowance' | 'marketplace_fee', nullable, required: The ceiling still closed, which blocks every restore; null when none is.
  - `next_cursor` string, nullable, required

## Other responses

- `400`: The request was malformed or failed validation.
- `401`: Missing or invalid credentials.

---

[API](https://skmtc.dev/naturali/apis/naturali-ai-api.md) · [All operations](https://skmtc.dev/naturali/apis/naturali-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/naturali/apis/naturali-ai-api/revisions/e4905b78f422?raw)