Skip to main content
GET
This endpoint allows you to retrieve all comments and notes that have been added to a specific contact. Comments provide historical context about interactions with the contact and can be helpful for team collaboration.

Use Cases

  • Review the conversation history with a contact
  • Prepare for a call or meeting by reviewing previous interactions
  • Track the progress of a relationship with a contact
  • Ensure team members are aware of important notes about the contact
  • Generate reports on engagement history

Path Parameters

string
requerido
The unique identifier of the contact whose comments you want to retrieve. This is a UUID string that was generated when the contact was created.

Headers

string
requerido
Your API key for authentication. You can find this in your dashboard under API settings.

Query Parameters

number
The maximum number of comments to return. Defaults to 50, maximum allowed is 100.
number
The number of comments to skip before starting to return results. Used for pagination. Defaults to 0.
string
The sort order for the comments. Possible values: newest (default), oldest.

Response

number
200 on success
array
Array of comment objects

Error Codes

  • 400 Bad Request - Invalid request parameters
  • 401 Unauthorized - Invalid or missing API key
  • 404 Not Found - Contact not found
  • 500 Internal Server Error - Server-side error

Code Examples

Notes and Best Practices

  • Use the sort parameter to display comments in the most useful order for your use case
  • Implement pagination in your application if the contact has many comments
  • Store comment IDs if you need to reference specific comments later
  • Consider implementing a comment categorization system in your application to better organize feedback
  • Keep sensitive information out of comments when possible, as they may be visible to multiple team members