---
title: "[DRAFT] Get Contact Notes"
method: GET
path: "/contacts/{contactId}/notes"
tags: ["contacts"]
---

# \[DRAFT\] Get Contact Notes

`GET /contacts/{contactId}/notes`

## Request

- Base URL: `https://api.acculynx.com/api/v2`
- URL: `https://api.acculynx.com/api/v2/contacts/{contactId}/notes`
- Auth: HTTP bearer

[DRAFT] Retrieves a paginated list of all notes entries
associated with a specific contact, sorted by createdDate in descending order (most recent first).

**Pagination:**
- PageStartIndex: Zero-based index of the first record to return (default: 0)
- PageSize: Number of records per page (default: 25, max: 100)
- Both pagination parameters are optional

**Behavior:**
- Returns 200 with an empty items array if the contact exists but has no notes
- Returns 400 if any Query String parameter (contactId, pageSize, recordStartIndex) doesn't fulfill the validations
- Returns 404 if the contactId does not exist
- Returns 416 if recordStartIndex or pageSize are negative, or exceeds the maximum allowed
- Returns 500 if an internal error occurs.

## Path parameters

- `contactId` string, uuid, required

## Query parameters

- `pageSize` integer
- `recordStartIndex` integer

## Response `200`

OK

- ContactNoteCollection
  - `count` integer: The total number of items matching the current query.
  - `pageSize` integer: The requested or default page size.
  - `pageStartIndex` integer: The requested or default index of the first element to return.
  - `items` ContactNote[]: An array of contact notes for the specified contact. Each item represents a note associated with the contact. The array may be empty if no notes exist within the requested range.
    - `id` string, uuid: The note's unique ID.
    - `_link` string: Use this URI to perform GET operations on the individual note resource. This link follows the pattern: /v2/contacts/{contactId}/notes/{noteId}
    - `note` string: A text with the note.
    - `createdDate` string, date-time: The DateTime when the note was created. An ISO 8601 string of datetime including the time component and ending with 'Z' (so in UTC). https://en.wikipedia.org/wiki/ISO_8601#Coordinated_Universal_Time_(UTC)
    - `createdBy` CompanyUserLink
      - `id` string, uuid: The unique GUID of the AccuLynx User.
      - `_link` string: The unique URI of the AccuLynx User.
    - `updatedDate` string, date-time: The DateTime when the note was updated. An ISO 8601 string of datetime including the time component and ending with 'Z' (so in UTC). https://en.wikipedia.org/wiki/ISO_8601#Coordinated_Universal_Time_(UTC)
    - `updatedBy` CompanyUserLink
      - `id` string, uuid: The unique GUID of the AccuLynx User.
      - `_link` string: The unique URI of the AccuLynx User.

## Other responses

- `400`: The request was malformed or contained invalid field values. Check the error response body for details.
- `401`: The API key provided is missing, invalid, or has been deactivated. Verify your API key and try again.
- `404`: The requested resource was not found. Verify the ID in the request path is correct and that the resource exists.
- `416`: Range Not Satisfiable.
- `500`: Internal Server Error. The issue has been logged and will be reviewed as soon as possible.

## Changes

- **2026-11-03** `443924b00f43`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/acculynx/apis/acculynx-api-v2/changes/contacts/:contactId/notes/get.md)

---

[API](https://skmtc.dev/acculynx/apis/acculynx-api-v2.md) - [All operations](https://skmtc.dev/acculynx/apis/acculynx-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/acculynx/apis/acculynx-api-v2/revisions/443924b00f43?raw)