# Stage Changes

The audit trail of every time an opportunity moved between pipeline stages.

**Base URL:** `https://api.trustpager.com/functions/v1/api/v1`

## Endpoints

### GET /stage-changes

List pipeline stage-change (card-movement) events — the audit trail of every time an opportunity moved between stages, on any pipeline. Each event records who moved it (moved_by, null = automation/system), the from-stage and to-stage (id + name), the pipeline, and when (moved_at). This is the source for "who moved this card out of <stage>, and when", card-movement reports, and stage-velocity analysis — human and automated moves alike, told apart by moved_by. Use human_only=true for people-only moves. Covers manual kanban drags, API/MCP moves, and automation moves.

**Scopes:** `opportunities:read` — [full detail](./stage-changes/get-stage-changes.md)