---
title: "GET /deals/movements_history"
method: GET
path: "/deals/movements_history"
tags: ["deals"]
---

# GET /deals/movements_history

`GET /deals/movements_history`

List deals stages changes in a time range.
            This allows to track everytime a deal had a movement between stages
            of a funnel or when it was won or lost.

## Query parameters

- `page` integer
- `per_page` integer
- `since` string, date-time
- `days_interval` integer

## Response `200`

OK

- object
  - `data` MovementHistoryEntity[]
    - `deal` object — Related deal.
      - `id` string
      - `title` string
    - `owner_user` object — Owner user.
      - `accountId` integer — Account ID.
      - `id` integer — User ID.
      - `name` string — User name.
    - `deal_stage` object — Deal stage info including ID and name.
      - `id` integer — Deal stage ID.
      - `name` string — Deal stage name.
      - `sequence` integer — Sequence number.
      - `funnel` object — Related funnel info.
        - `id` integer — Funnel ID.
        - `name` string — Funnel name.
    - `deal_status` object — Deal status info including ID and name.
      - `id` 1 | 2 | 3 — Deal status ID.
      - `name` 'Em andamento' | 'Ganho' | 'Perdido' — Deal status name
    - `updated_at` unknown
    - `audit_deal_id` integer — Audit deal ID.
    - `event_type` string — Event type.

---

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