# listPipelineTransitions

Stage-to-stage deal movement (the funnel) for a reporting period (same period values as getPipelineAnalytics), optionally narrowed to one pipelineId: per transition: deal counts, exits from the source stage, and won/lost outcomes. Data is a nightly snapshot: see asOfDate. Requires the ADMIN scope (key owner must be a team admin).

- Call: `POST https://server.goliathdata.com/api/v1/call` with `{ "operationId": "listPipelineTransitions", "variables": {...} }`
- Scope: `ADMIN`
- Type: query
- Idempotency: a read; rejects `Idempotency-Key`
- Rate-limited: yes

## Variables

- `pipelineId`: `ID`
- `period`: `AgentAnalyticsPeriod` (default `THIRTY_DAYS`, one of `SEVEN_DAYS`, `FOURTEEN_DAYS`, `THIRTY_DAYS`, `SIXTY_DAYS`, `THIS_MONTH`, `YEAR_TO_DATE`)

## Response (data, an example)

```json
{
  "teamAnalyticsQuery": {
    "agentPipelineTransitions": [
      {
        "asOfDate": "…",
        "pipelineId": "<ID>",
        "pipelineName": "…",
        "fromStageId": "…",
        "fromStageName": "…",
        "toStageId": "…",
        "toStageName": "…",
        "transitionDealsCount": 0,
        "fromStageExitDealsCount": 0,
        "wonTransitionDealsCount": 0,
        "lostTransitionDealsCount": 0,
        "transitionsToWonStage": true,
        "transitionsToLostStage": true
      }
    ]
  }
}
```

## Example

```bash
curl https://server.goliathdata.com/api/v1/call \
  -H "Authorization: Bearer $GOLIATH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operationId": "listPipelineTransitions",
    "variables": {}
  }'
```