# Laneboard Board Statistics

> Cards per list, label and person, overdue work, WIP limits, cycle time and throughput. Counts a kanban board the way a team review needs it: open cards per list against WIP limits, per label and per assignee, due dates (overdue, today, soon), checklist progress, lead and cycle times from the card history, throughput and the oldest work in progress. Also exports every card as CSV.

Part of usefulweb.app (https://usefulweb.app/). Part of [Laneboard](https://laneboard.usefulweb.app/) (ownerApp: laneboard). Results are deterministic calculations from the inputs and the listed assumptions; the API returns exactly what the web page shows.

## Use it
- Human interface: https://laneboardboardstats.usefulweb.app/ (interactive tool at https://laneboardboardstats.usefulweb.app/tool)
- JSON API: POST https://laneboardboardstats.usefulweb.app/api/v1/calculate with a JSON object of inputs (schema: https://laneboardboardstats.usefulweb.app/api/v1/tool)
- OpenAPI: https://laneboardboardstats.usefulweb.app/openapi.json
- MCP (Streamable HTTP): https://laneboardboardstats.usefulweb.app/mcp - tool `laneboard_board_stats`

## Inputs
- board (textarea): Board (JSON) - A Laneboard project or board file (.laneboard.json), a Laneboard share snapshot, or a Trello board export (JSON).
- boardFile (file): Board file (optional) - Used instead of the pasted text when given.
- boardName (text): Board (projects with several boards) - Board title or number (1 = first). Empty = the board that was open last.
- asOf (date): As of (date) - The day the numbers are counted for. Empty = today.
- soonDays (integer): Due soon = within (days)
- startList (text): Work starts in list - Cycle time starts when a card first enters this list or a later one. Empty = the second list.
- doneList (text): Done list - Empty = the last list.

## Method
- Open cards are cards that are not archived in lists that are not archived. Cards in the done list count as finished; due-date counts and per-label/per-person counts use the unfinished ones.
- Lead time = from a card’s creation to the last time it entered the done list. Cycle time = from the first time it entered the start list (or any list after it) to that moment. Both in days, from the card history Laneboard writes on every move (or rebuilt from Trello’s actions).
- Median, mean and 85th percentile (nearest rank) over the finished cards. Throughput = finished cards whose last move into the done list lies within 7 and 30 days up to the “as of” date (inclusive).
- Work item age of cards between the start list and the done list = days since they first entered the start list (or a later list), counted to the end of the “as of” day.
- Due states: overdue = due date before the “as of” day and not marked done; today; soon = within the chosen number of days after it.

## Limits
- Times come from the card history; cards moved before the history started (for example in old imports) only count from their first recorded step.