---
title: "List files attached to a deal"
method: GET
path: "/deals/{id}/files"
tags: ["Deals"]
---

# List files attached to a deal

`GET /deals/{id}/files`

Lists files associated with a deal.

## Path parameters

- `id` integer, required

## Query parameters

- `start` integer
- `limit` integer
- `sort` string

## Response `200`

Success

- object
  - `success` boolean — If the response is successful or not
  - `data` object[] — The array of files
    - `id` integer — The ID of the file
    - `user_id` integer — The ID of the user to associate the file with
    - `deal_id` integer — The ID of the deal to associate the file with
    - `person_id` integer — The ID of the person to associate the file with
    - `org_id` integer — The ID of the organization to associate the file with
    - `product_id` integer — The ID of the product to associate the file with
    - `activity_id` integer — The ID of the activity to associate the file with
    - `lead_id` string, uuid — The ID of the lead to associate the file with
    - `add_time` string — The date and time when the file was added/created. Format: YYYY-MM-DD HH:MM:SS
    - `update_time` string — The last updated date and time of the file. Format: YYYY-MM-DD HH:MM:SS
    - `file_name` string — The original name of the file
    - `file_size` integer — The size of the file
    - `active_flag` boolean — Whether the user is active or not. false = Not activated, true = Activated
    - `inline_flag` boolean — Whether the file was uploaded as inline or not
    - `remote_location` string — The location type to send the file to. Only googledrive is supported at the moment.
    - `remote_id` string — The ID of the remote item
    - `cid` string — The ID of the inline attachment
    - `s3_bucket` string — The location of the cloud storage
    - `mail_message_id` string — The ID of the mail message to associate the file with
    - `mail_template_id` string — The ID of the mail template to associate the file with
    - `deal_name` string — The name of the deal associated with the dile
    - `person_name` string — The name of the person associated with the file
    - `org_name` string — The name of the organization associated with the file
    - `product_name` string — The name of the product associated with the file
    - `lead_name` string — The name of the lead associated with the file
    - `url` string — The URL of the download file
    - `name` string — The visible name of the file
    - `description` string — The description of the file
  - `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

---

[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)