Skip to main content
GET
/
companies
/
{companyId}
/
notes
Get Company Notes
curl --request GET \
  --url https://api.lemlist.com/api/companies/{companyId}/notes \
  --header 'Authorization: Basic <encoded-value>'
{
  "data": [
    {
      "_id": "act_42k26Chi3iya8rfjX",
      "teamId": "tea_b4rMsi2trB42WyuWP",
      "companyId": "cpn_9Q9wjZR9R7rs3HE53",
      "createdAt": "2025-10-28T04:25:00.653Z",
      "note": "could help our GTM team be more productive",
      "userId": "usr_gmHgNGRcGPSTJrDbT"
    },
    {
      "_id": "act_QTehBr844jD2a72hn",
      "teamId": "tea_b4rMsi2trB42WyuWP",
      "companyId": "cpn_9Q9wjZR9R7rs3HE53",
      "createdAt": "2025-10-24T12:42:40.605Z",
      "note": "Note created from the API!",
      "userId": "usr_gmHgNGRcGPSTJrDbT"
    }
  ],
  "total": 2
}
This endpoint uses the Company Note object.

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

​
companyId
string
required

The unique identifier of the company

Query Parameters

​
limit
integer

Number of notes to retrieve. Default: 100. Maximum: 100

​
page
integer

Page number to retrieve

​
sortBy
enum<string>

The field by which to sort. Currently, only 'createdAt' is supported.

Available options:
createdAt
​
sortOrder
enum<string>

The sort direction. Use 'desc' for descending order; any other value (or omission) will sort in ascending order.

Available options:
asc,
desc

Response

Success

​
data
object[]
required
​
total
integer
required