Skip to main content
GET
List notes for a person or company
Returns the notes attached to a person (Contact) or a company (Company), resolved from the identifiers you provide. This is resolve-only: unlike Create a Note, it never creates a record. If no matching person or company exists, it returns 404. Notes come back sorted pinned first, then by createdAt descending.

Query Parameters

Person identifiers (type=person)

Supply at least one of linkedin_url, email, crm_id, or phone.

Company identifiers (type=company)

Supply at least one of website_url or name.

Response

Note Object

Example Request

Errors

Authorizations

x-api-key
string
header
required

Query Parameters

type
enum<string>
required

Target type. Determines which identifier fields are required.

Available options:
person,
company
linkedin_url
string

LinkedIn profile URL (person only)

email
string

Email address (person only)

crm_id
string

External CRM identifier (person only)

phone
string

Phone number in E.164 format (person only)

website_url
string

Company website URL (company only)

name
string

Company name (company only)

Response

Notes retrieved successfully

type
enum<string>

Target type echoed from the request

Available options:
person,
company
contact_id
string | null

Resolved unified Contact ID (present when type=person). Stable across reimports and dialer drains.

Example:

"507f1f77bcf86cd799439011"

company_id
string | null

Resolved unified Company ID (present when type=company).

Example:

"507f1f77bcf86cd799439012"

notes
object[]

Notes attached to the resolved target, pinned first then by creation date descending