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

# GET /deals/movements_history

`GET /deals/movements_history`

## Request

- Base URL: `https://api.agendor.com.br/v3`
- URL: `https://api.agendor.com.br/v3/deals/movements_history`
- Auth: API key in header `Authorization`

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

## Request body `application/x-www-form-urlencoded`

- object
  - `event_type` string[]: Filter by event type. Possible values are: stage_changed, status_changed, and deal_created. You can provide one or more values separating them by commas without spaces. Example: stage_changed,status_changed. When value is not provided, all events are returned.

## Response `200`

OK

- object
  - `data` MovementHistoryEntity[]
    - `deal` object: Related deal.
      - `id` string
      - `title` string
      - `currency` object: Currency this deal is denominated in. Null means BRL.
        - `id` integer: Currency ID.
        - `isoCode` string: ISO 4217 currency code (e.g. USD).
        - `name` string: Currency name.
        - `symbol` string: Currency symbol (e.g. $).
      - `exchangeRate` number, float: Exchange rate to BRL currently applied to this deal. Null when the deal is in BRL.
      - `exchangeRateSource` 'deal' | 'closed' | 'account': Where the applied exchange rate comes from: 'deal' (manual override), 'closed' (frozen when the deal was won/lost) or 'account' (current account rate). Null when the deal is in BRL.
      - `valueInBrl` number, float: Monetary value converted to BRL. Equal to value when the deal is in BRL.
    - `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.dev/agendor/apis/agendor-api.md) - [All operations](https://skmtc.dev/agendor/apis/agendor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agendor/apis/agendor-api/revisions/86c250dbf468?raw)