---
title: "List products associated with a person"
method: GET
path: "/persons/{id}/products"
tags: ["Persons"]
---

# List products associated with a person

`GET /persons/{id}/products`

Lists products associated with a person.

## Path parameters

- `id` integer, required

## Query parameters

- `start` integer
- `limit` integer

## Response `200`

Success

- object
  - `success` boolean — If the response is successful or not
  - `data` object[] — The array of deal products
    - `DEAL_ID` object
      - `deal` object
        - `id` integer — The ID of the deal
        - `company_id` integer — The ID of the company
        - `creator_user_id` integer — The ID of the deal creator
        - `user_id` integer — The ID of the user
        - `person_id` integer — The ID of the person associated with the deal
        - `org_id` integer — The ID of the organization associated with the deal
        - `stage_id` integer — The ID of the deal stage
        - `title` string — The title of the deal
        - `value` number — The value of the deal
        - `currency` string — The currency associated with the deal
        - `add_time` string — The creation date and time of the deal
        - `first_add_time` string — The first creation date and time of the deal
        - `update_time` string — The last updated date and time of the deal
        - `stage_change_time` string — The last updated date and time of the deal stage
        - `active` boolean — Whether the deal is active or not
        - `deleted` boolean — Whether the deal is deleted or not
        - `status` string — The status of the deal
        - `probability` number, nullable — The success probability percentage of the deal
        - `next_activity_date` string — The date of the next activity associated with the deal
        - `next_activity_time` string — 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
        - `lost_reason` string, nullable — The reason for losing the deal
        - `visible_to` string — The visibility of the deal
        - `close_time` string, nullable — The date and time of closing the deal
        - `pipeline_id` integer — The ID of the pipeline associated with the deal
        - `won_time` string — The date and time of changing the deal status as won
        - `first_won_time` string — The date and time of the first time changing the deal status as won
        - `lost_time` string — The date and time of changing the deal status as lost
        - `products_count` integer — The number of products associated with the deal
        - `files_count` integer — The number of files associated with the deal
        - `notes_count` integer — The number of notes associated with the deal
        - `followers_count` integer — The number of followers associated with the deal
        - `email_messages_count` integer — The number of emails associated with the deal
        - `activities_count` integer — The number of activities associated with the deal
        - `done_activities_count` integer — The number of completed activities associated with the deal
        - `undone_activities_count` integer — The number of incomplete activities associated with the deal
        - `participants_count` integer — The number of participants associated with the deal
        - `expected_close_date` string, date — The expected close date of the deal
        - `last_incoming_mail_time` string — The date and time of the last incoming email associated with the deal
        - `last_outgoing_mail_time` string — The date and time of the last outgoing email associated with the deal
        - `label` string — The label or multiple labels assigned to the deal
      - `product` object
        - `id` integer — The ID of the product
        - `company_id` integer — The ID of the company
        - `name` string — The name of the product
        - `code` string — The product code
        - `description` string — The description of the product
        - `unit` string — The unit in which this product is sold
        - `tax` number — The tax percentage
        - `category` string — The category of the product
        - `active_flag` boolean — Whether this product will be made active or not
        - `selectable` boolean — Whether this product can be selected in deals or not
        - `first_char` string — The first letter of the product name
        - `visible_to` '1' | '3' | '5' | '7' — The visibility of the product. If omitted, the visibility will be set to the default visibility setting of this item type for the authorized user.<table><tr><th>Value</th><th>Description</th></tr><tr><td>`1`</td><td>Owner &amp; followers (private)</td></tr><tr><td>`3`</td><td>Entire company (shared)</td></tr></table>
        - `owner_id` integer — The ID of the user who will be marked as the owner of this product. When omitted, the authorized user ID will be used
        - `files_count` integer — The count of files
        - `add_time` string — The date and time when the product was added to the deal
        - `update_time` string — The date and time when the product was updated to the deal
        - `deal_id` integer — The ID of the deal
  - `additional_data` object
    - `pagination` object — Pagination details of the list
      - `start` integer — Pagination start
      - `limit` integer — Items shown per page
      - `more_items_in_collection` boolean — Whether there are more list items in the collection than displayed
      - `next_start` integer — Next pagination start

---

[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/revisions/bf863a979545/schema)
