Get a List of Notes

get

https://api.apollo.io/api/v1/notes

Endpoint essentials
API key access	`meetings/api/v1/notes/index` or `Master API key`
OAuth scopes	`notes_list`
Credit usage	`0 credits` Learn more about API pricing and credits.

Notes on Apollo let you keep track of info directly on prospect profiles.

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 (account_id, contact_id, contact_ids, opportunity_id, calendar_event_id, conversation_id, or conversation_ids). Use this endpoint to fetch notes with sorting and pagination support.

Query Params

contact_id

string

The ID of the contact whose notes you want to retrieve.

Example: 60a5c0b8e4b0c7001c4f1234

account_id

string

The ID of the account whose notes you want to retrieve.

Example: 60a5c0b8e4b0c7001c4f5678

opportunity_id

string

The ID of the opportunity whose notes you want to retrieve.

Example: 60a5c0b8e4b0c7001c4f9012

calendar_event_id

string

The ID of the calendar event whose notes you want to retrieve.

Example: 60a5c0b8e4b0c7001c4f3456

conversation_id

string

The ID of the conversation whose notes you want to retrieve.

Example: 60a5c0b8e4b0c7001c4f7890

conversation_ids

array of strings

An array of conversation IDs to filter notes by multiple conversations.

conversation_ids

contact_ids

array of strings

An array of contact IDs to filter notes by multiple contacts.

contact_ids

start_date

string

Filter notes created on or after this date. Must be a valid date string.

Example: 2024-01-01

sort_by_field

string

enum

Defaults to created_at

The field to sort results by. Defaults to created_at.

Allowed:

sort_direction

string

enum

Defaults to desc

The direction to sort results. Defaults to desc.

Allowed:

skip

integer

Defaults to 0

The number of notes to skip for pagination. Must be a non-negative integer. Defaults to 0.

limit

integer

≤ 100

Defaults to 25

The maximum number of notes to return per request. Defaults to 25. Maximum value is 100.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/plain

Get a List of Notes

What’s Next

What’s Next

200200

400400

401401

What’s Next

What’s Next