---
title: "Cdb Refill State"
method: GET
path: "/api/cdb/{scan_id}/refill-state"
---

# Cdb Refill State

`GET /api/cdb/{scan_id}/refill-state`

Polled by the CDB JS every 10 seconds. Returns the current
refill state machine value so the front-end can show the
notice box + drain bar when state == 'ready'. Auth via scan
password (same gate as the dispute endpoint).

CONSUME SEMANTIC: serving 'ready' transitions the state to
'idle' so the next reload doesn't re-show the notice. The
round_count and added_count remain unchanged so the intro text
update persists. If two clients poll simultaneously, one wins
the consume — both still see 'ready' once and reload to a fresh
page.

## Path parameters

- `scan_id` string, required

## Query parameters

- `password` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/aipoweredsocialscan/apis/accountability.md) · [All operations](https://skmtc.dev/aipoweredsocialscan/apis/accountability/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aipoweredsocialscan/accountability/revisions/6ce776993b65/schema)