---
title: "List updates about a deal"
method: GET
path: "/deals/{id}/flow"
tags: ["Deals"]
---

# List updates about a deal

`GET /deals/{id}/flow`

Lists updates about a deal.

## Path parameters

- `id` integer, required

## Query parameters

- `start` integer
- `limit` integer
- `all_changes` string
- `items` string

## Response `200`

Get the deal updates

- object
  - `success` boolean — If the response is successful or not
  - `data` object[]
    - `object` string — The type of the deal update. (Possible object types - dealChange, note, activity, mailMessage, invoice, document, file)
    - `timestamp` string — The creation date and time of the update
    - `data` object — The data related to the update
  - `additional_data` object — The additional data of the list
    - `start` integer — Pagination start
    - `limit` integer — Items shown per page
    - `more_items_in_collection` boolean — If there are more list items in the collection than displayed or not
  - `related_objects` object
    - `deal` object
      - `DEAL_ID` object — The ID of the deal which is associated with the item
        - `id` integer — The ID of the deal associated with the item
        - `title` string — The title of the deal associated with the item
        - `status` string — The status of the deal associated with the item
        - `value` number — The value of the deal that is associated with the item
        - `currency` string — The currency of the deal value
        - `stage_id` integer — The ID of the stage the deal is currently at
        - `pipeline_id` integer — The ID of the pipeline the deal is in
    - `organization` object
      - `ORGANIZATION_ID` object — The ID of the organization associated with the item
        - `id` integer — The ID of the organization associated with the item
        - `name` string — The name of the organization associated with the item
        - `people_count` integer — The number of people connected with the organization that is associated with the item
        - `owner_id` integer — The ID of the owner of the organization that is associated with the item
        - `address` string, nullable — The address of the organization
        - `cc_email` string, nullable — The BCC email of the organization associated with the item
    - `user` object
      - `USER_ID` object — The ID of the user
        - `id` integer — The ID of the user
        - `name` string — The name of the user
        - `email` string — The email of the user
        - `has_pic` integer — Whether the user has picture or not. 0 = No picture, 1 = Has picture.
        - `pic_hash` string, nullable — The user picture hash
        - `active_flag` boolean — Whether the user is active or not
    - `person` object
      - `PERSON_ID` object — The ID of the person associated with the item
        - `active_flag` boolean — Whether the associated person is active or not
        - `id` integer — The ID of the person associated with the item
        - `name` string — The name of the person associated with the item
        - `email` object[] — The emails of the person associated with the item
          - `label` string — The type of the email
          - `value` string — The email of the associated person
          - `primary` boolean — Whether this is the primary email or not
        - `phone` object[] — The phone numbers of the person associated with the item
          - `label` string — The type of the phone number
          - `value` string — The phone number of the person associated with the item
          - `primary` boolean — Whether this is the primary phone number or not
        - `owner_id` integer — The ID of the owner of the person that is associated with the item

---

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