---
title: "Get Deals Pipeline"
method: GET
path: "/reports/deals/pipeline"
tags: ["CRM Reports"]
---

# Get Deals Pipeline

`GET /reports/deals/pipeline`

## Request

- Base URL: `https://fapi.ambivo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://fapi.ambivo.com/reports/deals/pipeline`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/ambivo/apis/ambivo-api/docs/reports/deals/pipeline/get.ts> (a function with typed inputs; its response is checked against the schema)

Per-stage pipeline summary powered by `agent_period_performance_report` upstream.

## Query parameters

- `start_date` string, required: ISO date, inclusive
- `end_date` string, required: ISO date, inclusive
- `user_id` string, nullable: Scope to a single agent (omit for all)

## Response `200`

Successful Response

- DealsPipelineResponse
  - `stages` PipelineStageSummary[], required
    - `stage` string, required
    - `count` integer
    - `total_value` number
    - `total_commission` number
    - `avg_value` number
  - `start_date` string, nullable
  - `end_date` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-08-06** `165a6d16a9a0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ambivo/apis/ambivo-api/changes/reports/deals/pipeline/get.md)

---

[API](https://skmtc.dev/ambivo/apis/ambivo-api.md) - [All operations](https://skmtc.dev/ambivo/apis/ambivo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ambivo/apis/ambivo-api/revisions/165a6d16a9a0?raw)