Skip to main content
GET
/
v2
/
persons
/
{personId}
/
notes
Get Notes for a Person
curl --request GET \
  --url https://api.affinity.co/v2/persons/{personId}/notes \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 1,
      "type": "entities",
      "content": {
        "html": "<p>Met with the founding team to discuss the Series A term sheet.</p>"
      },
      "creator": {
        "id": 1,
        "firstName": "Jane",
        "lastName": "Smith",
        "primaryEmailAddress": "jane.smith@northpointvc.com",
        "type": "internal"
      },
      "mentions": [
        {
          "id": 1,
          "type": "person",
          "person": {
            "id": 1,
            "firstName": "Jane",
            "lastName": "Smith",
            "primaryEmailAddress": "jane.smith@northpointvc.com",
            "type": "internal"
          }
        }
      ],
      "createdAt": "2023-01-01T00:00:00Z",
      "updatedAt": "2023-01-01T00:00:00Z"
    },
    {
      "id": 2,
      "type": "entities",
      "content": {
        "html": "<p>This is another note!</p>"
      },
      "creator": {
        "id": 1,
        "firstName": "Jane",
        "lastName": "Smith",
        "primaryEmailAddress": "jane.smith@northpointvc.com",
        "type": "internal"
      },
      "mentions": [],
      "createdAt": "2024-01-01T00:00:00Z",
      "updatedAt": "2024-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "prevUrl": "https://api.affinity.co/v2/persons/1/notes?cursor=ICAgICAgYmVmb3JlOjo6Nw",
    "nextUrl": "https://api.affinity.co/v2/persons/1/notes?cursor=ICAgICAgIGFmdGVyOjo6NA"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
personId
integer<int64>
required

Persons ID

Required range: 1 <= x <= 9007199254740991

Query Parameters

​
filter
string

Filter options

​
cursor
string

Cursor for the next or previous page

​
limit
integer<int32>
default:20

Number of items to include in the page

Required range: 0 <= x <= 100
​
totalCount
boolean
default:false

Include total count of the collection in the pagination response

Response

OK

NotesPaged model

​
data
(notes.EntitiesNote · object | notes.InteractionNote · object | notes.AiNotetakerRootNote · object | notes.UserReplyNote · object | notes.AiNotetakerReplyNote · object)[]
required

A page of Note objects

Maximum array length: 100

A Note object attached to an entity (Person, Company, Opportunity)

Example:
{
  "id": 1,
  "type": "entities",
  "content": { "html": "<p>This is a note!</p>" },
  "creator": {
    "id": 1,
    "firstName": "Jane",
    "lastName": "Smith",
    "primaryEmailAddress": "jane.smith@northpointvc.com",
    "type": "internal"
  },
  "mentions": [],
  "createdAt": "2023-01-01T00:00:00Z",
  "updatedAt": "2023-01-21T00:00:00Z"
}
​
pagination
PaginationWithTotalCount · object
required