---
title: "Get personal notes for messages"
method: GET
path: "/notes"
tags: ["Message"]
---

# Get personal notes for messages

`GET /notes`

## Request

- Base URL: `https://api.carbonvoice.app`
- URL: `https://api.carbonvoice.app/notes`
- Auth: one of:
  - API key in header `pxtoken`
  - OAuth 2 (implicit, authorization URL `https://api.carbonvoice.app/oauth/authorize`)

## Response `200`

- PersonalNotesResponse
  - `notes` PersonalNote[], required
    - `message_id` string, required
    - `text` string, required
    - `last_updated` string, date-time, required
    - `message_created_at` string, date-time, required
    - `message_created_by` string, required
    - `message_workspace_ids` string[], required
    - `message_channel_ids` string[], required
  - `users` Contact[], required
    - `user_guid` string, required
    - `image_url` string, nullable, required
    - `first_name` string, required
    - `last_name` string, required
    - `languages` string[], required
    - `voice_gender` 'F' | 'M', required
    - `created_by` string, nullable, required
    - `created_at` string, date-time, required
    - `last_updated_at` string, date-time, nullable, required
    - `workspace_guids` string[], required
    - `workspace_roles` WorkspaceRole[], required
      - `workspace_id` string, required
      - `role` 'admin' | 'owner' | 'creator' | 'member' | 'guest', required
      - `joined_at` string, date-time, nullable
      - `sort_order` number, nullable
    - `is_allowed_to_receive_notification` boolean, required
    - `user_type` 'user' | 'bot' | 'agent', required
    - `is_agent` boolean, required
    - `owner_id` string, nullable, required
  - `success` boolean, required
  - `error_message` string, nullable, required

---

[API](https://skmtc.dev/carbonvoice/apis/carbon-voice-api.md) · [All operations](https://skmtc.dev/carbonvoice/apis/carbon-voice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carbonvoice/apis/carbon-voice-api/revisions/b91c5c845122?raw)