List updates about a deal
GET {{baseUrl}}/deals/:id/flow?start=0&limit=<integer>&all_changes=<string>&items=<string>
Lists updates about a deal.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
start | number | Pagination start | |
limit | string | Items shown per page | |
all_changes | string | Whether to show custom field updates or not. 1 = Include custom field changes. If omitted returns changes without custom field updates. | |
items | string | A comma-separated string for filtering out item specific updates. (Possible values - call, activity, plannedActivity, change, note, deal, file, dealChange, personChange, organizationChange, follower, dealFollower, personFollower, organizationFollower, participant, comment, mailMessage, mailMessageWithAttachment, invoice, document, marketing_campaign_stat, marketing_status_change). |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"success":true,"data":[{"object":"dealChange","timestamp":"2020-09-25 09:21:55","data":{"id":1300,"item_id":120,"user_id":8877,"field_key":"value","old_value":50,"new_value":100,"is_bulk_update_flag":null,"log_time":"2020-09-25 09:21:55","change_source":"app","change_source_user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML like Gecko) Chrome/84.0.4147.135 Safari/537.36","additional_data":[]}},{"object":"activity","timestamp":"2020-08-07 08:15:00","data":{"id":8,"company_id":22122,"user_id":1234,"done":false,"type":"deadline","reference_type":"scheduler-service","reference_id":7,"conference_meeting_client":"871b8bc88d3a1202","conference_meeting_url":"https://pipedrive.zoom.us/link","conference_meeting_id":"17058746701","due_date":"2020-06-09","due_time":"10:00","duration":"01:00","busy_flag":true,"add_time":"2020-06-08 12:37:56","marked_as_done_time":"2020-08-08 08:08:38","last_notification_time":"2020-08-08 12:37:56","last_notification_user_id":7655,"notification_language_id":1,"subject":"Deadline","public_description":"This is a description","calendar_sync_include_context":"","location":"Mustamäe tee 3, Tallinn, Estonia","org_id":5,"person_id":1101,"deal_id":300,"lead_id":"46c3b0e1-db35-59ca-1828-4817378dff71","project_id":null,"active_flag":true,"update_time":"2020-08-08 12:37:56","update_user_id":5596,"gcal_event_id":"","google_calendar_id":"","google_calendar_etag":"","source_timezone":"","rec_rule":"RRULE:FREQ=WEEKLY;BYDAY=WE","rec_rule_extension":"","rec_master_activity_id":1,"series":[],"note":"A note for the activity","created_by_user_id":1234,"location_subpremise":"","location_street_number":"3","location_route":"Mustamäe tee","location_sublocality":"Kristiine","location_locality":"Tallinn","location_admin_area_level_1":"Harju maakond","location_admin_area_level_2":"","location_country":"Estonia","location_postal_code":"10616","location_formatted_address":"Mustamäe tee 3, 10616 Tallinn, Estonia","attendees":[{"email_address":"attendee@pipedrivemail.com","is_organizer":0,"name":"Attendee","person_id":25312,"status":"noreply","user_id":null}],"participants":[{"person_id":17985,"primary_flag":false},{"person_id":1101,"primary_flag":true}],"org_name":"Organization","person_name":"Person","deal_title":"Deal","owner_name":"Creator","person_dropbox_bcc":"company@pipedrivemail.com","deal_dropbox_bcc":"company+deal300@pipedrivemail.com","assigned_to_user_id":1235,"file":{"id":"376892,","clean_name":"Audio 10:55:07.m4a","url":"https://pipedrive-files.s3-eu-west-1.amazonaws.com/Audio-recording.m4a"}}},{"object":"mailMessage","timestamp":"2020-08-10 11:52:26","data":{"attachments":[{"id":1,"user_id":8877,"deal_id":1,"person_id":1,"org_id":1480,"product_id":1,"activity_id":1,"lead_id":"adf21080-0e10-11eb-879b-05d71fb426ec","log_id":null,"add_time":"2020-09-16 11:19:36","update_time":"2020-09-16 11:19:36","file_name":"95781006_794143070992462_4330873630616453120_n_60817458877506f9eb74d03e5ef9ba061915b797998.jpg","file_type":"img","file_size":95116,"active_flag":true,"inline_flag":false,"remote_location":"s3","remote_id":"95781006_794143070992462_4330873630616453120_n.jpg","cid":"","s3_bucket":"","mail_message_id":"","mail_template_id":"","deal_name":"nice deal","person_name":"","people_name":"","org_name":"Pipedrive Inc.","product_name":"","lead_name":"nice lead","url":"https://app.pipedrive.com/api/v1/files/304/download","name":"95781006_794143070992462_4330873630616453120_n.jpg","description":""}],"id":1,"from":[{"id":1,"email_address":"mail@example.org","name":"Test","linked_person_id":1,"linked_person_name":"","mail_message_party_id":1}],"to":[{"id":1,"email_address":"mail@example.org","name":"Test","linked_person_id":1,"linked_person_name":"","mail_message_party_id":1}],"cc":[{"id":1,"email_address":"mail@example.org","name":"Test","linked_person_id":1,"linked_person_name":"","mail_message_party_id":1}],"bcc":[{"id":1,"email_address":"mail@example.org","name":"Test","linked_person_id":1,"linked_person_name":"","mail_message_party_id":1}],"body_url":"https://example.org","nylas_id":"8cfw8n7l4iy24xxxxxxxxx","account_id":"ao5gpry0zykr1xxxxxxxxx","user_id":1,"mail_thread_id":1,"subject":"test subject","snippet":"test subject","mail_tracking_status":"opened","mail_link_tracking_enabled_flag":0,"read_flag":1,"draft":"","s3_bucket":"pipedrive-mail-live-fr","s3_bucket_path":"e9cf-6081745/77777/nylas/111/1111/body","draft_flag":0,"synced_flag":1,"deleted_flag":0,"external_deleted_flag":false,"has_body_flag":1,"sent_flag":0,"sent_from_pipedrive_flag":0,"smart_bcc_flag":0,"message_time":"2019-11-14T06:02:06.000Z","add_time":"2019-11-14T06:02:06.000Z","update_time":"2019-11-14T07:15:49.000Z","has_attachments_flag":1,"has_inline_attachments_flag":0,"has_real_attachments_flag":1,"mua_message_id":"8cfw8n7l4iy24lfhnexxxxxx-0@mailer.nylas.com","template_id":1,"item_type":"mailMessage","timestamp":"2020-09-16T13:37:50.000Z","company_id":6081745}}],"additional_data":{"pagination":{"start":0,"limit":100,"more_items_in_collection":true}},"related_objects":{"allOf":[{"user":{"123":{"id":123,"name":"Jane Doe","email":"jane@pipedrive.com","has_pic":1,"pic_hash":"2611ace8ac6a3afe2f69ed56f9e08c6b","active_flag":true}}},{"person":{"1101":{"active_flag":true,"id":1101,"name":"Person","email":[{"label":"work","value":"person@pipedrive.com","primary":true}],"phone":[{"label":"work","value":"3421787767","primary":true}],"owner_id":8877}}},{"organization":{"1":{"id":1,"name":"Org Name","people_count":1,"owner_id":123,"address":"Mustamäe tee 3a, 10615 Tallinn","active_flag":true,"cc_email":"org@pipedrivemail.com"}}},{"deal":{"123":{"id":123,"title":"Deal title","status":"open","value":600,"currency":"EUR","stage_id":2,"pipeline_id":1}}}]}}