---
title: "Get all notes"
method: GET
path: "/notes"
tags: ["Notes"]
---

# Get all notes

`GET /notes`

Returns all notes.

## Query parameters

- `user_id` integer
- `lead_id` string, uuid
- `deal_id` integer
- `person_id` integer
- `org_id` integer
- `project_id` integer
- `task_id` integer
- `start` integer
- `limit` integer
- `sort` string
- `start_date` string, date
- `end_date` string, date
- `updated_since` string, date-time
- `pinned_to_lead_flag` 0 | 1
- `pinned_to_deal_flag` 0 | 1
- `pinned_to_organization_flag` 0 | 1
- `pinned_to_person_flag` 0 | 1
- `pinned_to_project_flag` 0 | 1
- `pinned_to_task_flag` 0 | 1

## Response `200`

Get all notes

- object
  - `success` boolean — If the request was successful or not
  - `data` object[] — The array of notes
    - `id` integer — The ID of the note
    - `active_flag` boolean — Whether the note is active or deleted
    - `add_time` string — The creation date and time of the note
    - `content` string — The content of the note in HTML format. Subject to sanitization on the back-end.
    - `deal` object — The deal this note is attached to
      - `title` string — The title of the deal this note is attached to
    - `lead_id` string, uuid — The ID of the lead the note is attached to
    - `deal_id` integer — The ID of the deal the note is attached to
    - `last_update_user_id` integer — The ID of the user who last updated the note
    - `org_id` integer — The ID of the organization the note is attached to
    - `organization` object — The organization the note is attached to
      - `name` string — The name of the organization the note is attached to
    - `person` object — The person the note is attached to
      - `name` string — The name of the person the note is attached to
    - `person_id` integer — The ID of the person the note is attached to
    - `project_id` integer — The ID of the project the note is attached to
    - `project` object — The project the note is attached to
      - `title` string — The title of the project the note is attached to
    - `task_id` integer — The ID of the task the note is attached to
    - `task` object — The task the note is attached to
      - `title` string — The title of the task the note is attached to
    - `pinned_to_deal_flag` boolean — If true, the results are filtered by note to deal pinning state
    - `pinned_to_organization_flag` boolean — If true, the results are filtered by note to organization pinning state
    - `pinned_to_person_flag` boolean — If true, the results are filtered by note to person pinning state
    - `pinned_to_project_flag` boolean — If true, the results are filtered by note to project pinning state
    - `pinned_to_task_flag` boolean — If true, the results are filtered by note to task pinning state
    - `update_time` string — The last updated date and time of the note
    - `user` object — The user who created the note
      - `email` string — The email of the note creator
      - `icon_url` string — The URL of the note creator avatar picture
      - `is_you` boolean — Whether the note is created by you or not
      - `name` string — The name of the note creator
    - `user_id` integer — The ID of the note creator
  - `additional_data` object
    - `pagination` object — The pagination details of the list
      - `next_start` integer — Next pagination start
      - `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)
