Intercom API (unofficial showcase)
GET/contacts/{contact_id}/notes

List notes for a contact

Lists notes associated with a contact. Use the contact_id path parameter to identify the contact; the response includes cursor-based pagination metadata and the total note count.

2 parameters
contact_idstringrequired
The unique identifier of the contact whose notes to retrieve.
Intercom-Versionstringoptional
The Intercom API version to use; the listed values include 1.0 through 2.6. Defaults to 2.17 when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

2 status codes
200Returns a paginated list of notes associated with the contact, with the total note count and cursor-based pagination metadata.
typestringoptional
String representing the object's type. Always has the value `list`.
dataarray<Note>optional
An array of notes.
total_countintegeroptional
A count of the total number of notes.
pagesobjectoptional
Cursor-based pagination is a technique used in the Intercom API to navigate through large amounts of data. A "cursor" or pointer is used to keep track of the current position in the result set, allowing the API to return the data in small chunks or "pages" as needed.
404Returned when the contact is not found.

One documented failure

  • not_found

    User Not Found

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects

Error handling

A 404 is returned when the contact identified by the contact_id path parameter is not found. The Intercom-Version header selects the API version and defaults to 2.17 when omitted.