---
title: "Get a List of Notes"
method: GET
path: "/notes"
tags: ["Miscellaneous"]
---

# Get a List of Notes

`GET /notes`

This endpoint doesn't consume Apollo credits. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).

<a href="https://knowledge.apollo.io/hc/en-us/articles/28746467476365-Notes-Overview" target="_blank">Notes</a> on Apollo let you keep track of info directly on prospect profiles.<br><br>The Get a List of Notes endpoint retrieves notes associated with a specific contact, account, opportunity, calendar event, or conversation in your Apollo account. You must provide at least one relation parameter (<code>account_id</code>, <code>contact_id</code>, <code>contact_ids</code>, <code>opportunity_id</code>, <code>calendar_event_id</code>, <code>conversation_id</code>, or <code>conversation_ids</code>). Use this endpoint to fetch notes with sorting and pagination support.

## Query parameters

- `contact_id` string
- `account_id` string
- `opportunity_id` string
- `calendar_event_id` string
- `conversation_id` string
- `conversation_ids` string[]
- `contact_ids` string[]
- `start_date` string
- `sort_by_field` 'created_at' | 'updated_at'
- `sort_direction` 'asc' | 'desc'
- `skip` integer
- `limit` integer

## Response `200`

200

- object
  - `notes` object[]
    - `id` string — The unique identifier of the note.
    - `user_id` string — The ID of the user who created the note.
    - `content` string — The content of the note.
    - `updated_at` string — The timestamp when the note was last updated.
    - `created_at` string — The timestamp when the note was created.
    - `contact_id` string, nullable — The ID of the associated contact.
    - `conversation_id` string, nullable — The ID of the associated conversation.
    - `account_id` string, nullable — The ID of the associated account.
    - `pinned_to_top` boolean — Whether the note is pinned to the top.
    - `system` boolean — Whether this is a system-generated note.
    - `opportunity_id` string, nullable — The ID of the associated opportunity.
    - `account_ids` string[] — Array of associated account IDs.
    - `contact_ids` string[] — Array of associated contact IDs.
    - `opportunity_ids` string[] — Array of associated opportunity IDs.
    - `calendar_event_ids` string[] — Array of associated calendar event IDs.
    - `conversation_ids` string[] — Array of associated conversation IDs.
    - `is_org_chart_note` boolean — Whether this note is an org chart note.
    - `crm_notes` unknown[] — Array of associated CRM note records.
      - unknown

## Other responses

- `400` — 400
- `401` — 401

---

[API](https://skmtc.dev/apollo/apis/apollo-rest-api.md) · [All operations](https://skmtc.dev/apollo/apis/apollo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apollo/apollo-rest-api/revisions/c715a05fa6e2/schema)