---
title: "Post Deals Timeline"
method: POST
path: "/reports/deals/timeline"
tags: ["CRM Reports", "CRM Reports"]
---

# Post Deals Timeline

`POST /reports/deals/timeline`

Deal count + total value bucketed by month/week over the period.

Fetches deals from upstream and buckets in-process (no upstream date-grouping
available yet).

## Request body

- DealsTimelineRequest
  - `start_date` string, required — ISO date string (inclusive)
  - `end_date` string, required — ISO date string (inclusive)
  - `bucket` string
  - `user_id` string, nullable

## Response `200`

Successful Response

- DealsTimelineResponse
  - `points` DealsTimelinePoint[], required
    - `period` string, required
    - `count` integer, required
    - `total_value` number, required
  - `bucket` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ambivo/apis/ambivo-api.md) · [All operations](https://skmtc.net/ambivo/apis/ambivo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ambivo/ambivo-api/revisions/165a6d16a9a0/schema)