--- title: "List participants of a deal" method: GET path: "/deals/{id}/participants" tags: ["Deals"] --- # List participants of a deal `GET /deals/{id}/participants` Lists the participants associated with a deal.
If a company uses the [Campaigns product](https://pipedrive.readme.io/docs/campaigns-in-pipedrive-api), then this endpoint will also return the `data.marketing_status` field. ## Path parameters - `id` integer, required ## Query parameters - `start` integer - `limit` integer ## Response `200` Get all deal participants by the DealID - object - `success` boolean — If the request was successful or not - `data` object[] — The array of participants - `id` integer — The ID of the participant - `person_id` object — The person data associated with the participant - `active_flag` boolean — Whether the person is active or not - `name` string — The name of the person - `email` object[] — An email address as a string or an array of email objects related to the person. The structure of the array is as follows: `[{ "value": "mail@example.com", "primary": "true", "label": "main" }]`. Please note that only `value` is required. - `value` string — The email address - `primary` boolean — Boolean that indicates if email is primary for the person or not - `label` string — The label that indicates the type of the email. (Possible values - work, home or other) - `phone` object[] — A phone number supplied as a string or an array of phone objects related to the person. The structure of the array is as follows: `[{ "value": "12345", "primary": "true", "label": "mobile" }]`. Please note that only `value` is required. - `value` string — The phone number - `primary` boolean — Boolean that indicates if phone number is primary for the person or not - `label` string — The label that indicates the type of the phone number. (Possible values - work, home, mobile or other) - `owner_id` integer — The ID of the owner of the person - `company_id` integer — The ID of the company related to the person - `value` integer — The ID of the person - `add_time` string — The date and time when the participant was added. Format: YYYY-MM-DD HH:MM:SS - `active_flag` boolean — Whether the participant is active or not - `related_item_data` object — Information about the related deal - `deal_id` integer — The ID of the deal - `title` string — The title of the deal - `person` object - `id` integer — The ID of the person - `company_id` integer — The ID of the company related to the person - `active_flag` boolean — Whether the person is active or not - `phone` object[] — A phone number supplied as a string or an array of phone objects related to the person. The structure of the array is as follows: `[{ "value": "12345", "primary": "true", "label": "mobile" }]`. Please note that only `value` is required. - `value` string — The phone number - `primary` boolean — Boolean that indicates if phone number is primary for the person or not - `label` string — The label that indicates the type of the phone number. (Possible values - work, home, mobile or other) - `email` object[] — An email address as a string or an array of email objects related to the person. The structure of the array is as follows: `[{ "value": "mail@example.com", "primary": "true", "label": "main" } ]`. Please note that only `value` is required. - `value` string — Email - `primary` boolean — Boolean that indicates if email is primary for the person or not - `label` string — The label that indicates the type of the email. (Possible values - work, home or other) - `first_char` string — The first letter of the name of the person - `add_time` string — The date and time when the person was added/created. Format: YYYY-MM-DD HH:MM:SS - `update_time` string — The last updated date and time of the person. Format: YYYY-MM-DD HH:MM:SS - `visible_to` string — The visibility group ID of who can see the person - `picture_id` object, nullable - `id` integer — The ID of the picture associated with the item - `item_type` string — The type of item the picture is related to - `item_id` integer — The ID of related item - `active_flag` boolean — Whether the associated picture is active or not - `add_time` string — The add time of the picture - `update_time` string — The update time of the picture - `added_by_user_id` integer — The ID of the user who added the picture - `pictures` object - `128` string — The URL of the 128*128 picture - `512` string — The URL of the 512*512 picture - `label` integer, nullable — The label assigned to the person. When the `label` field is updated, the `label_ids` field value will be overwritten by the `label` field value. - `label_ids` integer[] — The IDs of labels assigned to the person. When the `label_ids` field is updated, the `label` field value will be set to the first value of the `label_ids` field. - `org_name` string, nullable — The name of the organization associated with the person - `owner_name` string — The name of the owner associated with the person - `cc_email` string, nullable — The BCC email associated with the person - `owner_id` object - `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 - `value` integer — The ID of the owner - `org_id` object, nullable - `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 - `label_ids` integer[] — The IDs of labels assigned to the organization - `value` integer — The ID of the organization - `active_flag` boolean — Whether the associated organization is active or not - `name` string — The name of the person - `first_name` string — The first name of the person - `last_name` string, nullable — The last name of the person - `email_messages_count` integer — The count of email messages related to the person - `activities_count` integer — The count of activities related to the person - `done_activities_count` integer — The count of done activities related to the person - `undone_activities_count` integer — The count of undone activities related to the person - `files_count` integer — The count of files related to the person - `notes_count` integer — The count of notes related to the person - `followers_count` integer — The count of followers related to the person - `last_incoming_mail_time` string, nullable — The date and time of the last incoming email associated with the person - `last_outgoing_mail_time` string, nullable — The date and time of the last outgoing email associated with the person - `open_deals_count` integer — The count of open deals related with the item - `related_open_deals_count` integer — The count of related open deals related with the item - `closed_deals_count` integer — The count of closed deals related with the item - `related_closed_deals_count` integer — The count of related closed deals related with the item - `won_deals_count` integer — The count of won deals related with the item - `related_won_deals_count` integer — The count of related won deals related with the item - `lost_deals_count` integer — The count of lost deals related with the item - `related_lost_deals_count` integer — The count of related lost deals related with the item - `next_activity_date` string, nullable — The date of the next activity associated with the deal - `next_activity_time` string, nullable — The time of the next activity associated with the deal - `next_activity_id` integer, nullable — The ID of the next activity associated with the deal - `last_activity_id` integer, nullable — The ID of the last activity associated with the deal - `last_activity_date` string, nullable — The date of the last activity associated with the deal - `added_by_user_id` object - `success` boolean — If the response is successful or not - `data` object - `id` integer — The user ID - `name` string — The user name - `default_currency` string — The user default currency - `locale` string — The user locale - `lang` integer — The user language ID - `email` string — The user email - `phone` string, nullable — The user phone - `activated` boolean — Boolean that indicates whether the user is activated - `last_login` string — The last login date and time of the user. Format: YYYY-MM-DD HH:MM:SS - `created` string — The creation date and time of the user. Format: YYYY-MM-DD HH:MM:SS - `modified` string, nullable — The last modification date and time of the user. Format: YYYY-MM-DD HH:MM:SS - `has_created_company` boolean — Boolean that indicates whether the user has created a company - `access` object[] - `app` 'global' | 'sales' | 'campaigns' | 'projects' | 'account_settings' | 'partnership' — The granular app access level - `admin` boolean — Whether the user has admin access or not - `permission_set_id` string — The ID of the permission set - `active_flag` boolean — Boolean that indicates whether the user is activated - `timezone_name` string — The user timezone name - `timezone_offset` string — The user timezone offset - `role_id` integer — The ID of the user role - `icon_url` string, nullable — The user icon URL - `is_you` boolean — Boolean that indicates if the requested user is the same which is logged in (in this case, always true) - `is_deleted` boolean — Boolean that indicates whether the user is deleted from the company - `related_item_type` string — The type of the related item - `related_item_id` integer — The ID of the related item - `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 - `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 - `organization` object - `ORGANIZATION_ID` object — The ID of the organization associated with the item - `active_flag` boolean — Whether the associated organization is active or not - `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 - `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)