> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thena.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get all account notes

> MCP tool to retrieve a paginated list of all notes for a specific account in the Thena platform.

import Admonition from '@theme/Admonition';

### MCP tool: `get_all_account_notes`

Retrieves a paginated list of all notes for a specific account. This tool supports pagination for efficient data retrieval and provides comprehensive note information including content, type, visibility, and author details.

<Admonition type="note">
  This tool requires an account ID and supports pagination for efficient data retrieval.
</Admonition>

### Example prompt

```prompt theme={null}
Get all notes for account ACC001
```

<Admonition type="info">
  When you use this prompt in a chat with the model (with the MCP tool registered), the model will automatically call the <code>get\_all\_account\_notes</code> tool with the correct arguments.
</Admonition>

### Input parameters

| Name      | Type   | Required | Description                                     |
| --------- | ------ | -------- | ----------------------------------------------- |
| accountId | string | Yes      | The identifier of the account to find notes for |
| page      | number | No       | Page number for pagination (default: 1)         |
| limit     | number | No       | Number of notes per page (default: 10)          |

### Response fields

Below are the fields you may see in each account note object in the response:

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr><td>id</td><td>string</td><td>Unique identifier of the note</td></tr>
    <tr><td>accountId</td><td>string</td><td>ID of the account the note belongs to</td></tr>
    <tr><td>account</td><td>string</td><td>Name of the account</td></tr>
    <tr><td>content</td><td>string</td><td>The content of the note</td></tr>
    <tr><td>type</td><td>string</td><td>The type of the note (e.g., "Internal", "Customer")</td></tr>
    <tr><td>typeId</td><td>string</td><td>ID of the note type attribute</td></tr>
    <tr><td>typeConfiguration</td><td>object</td><td>Configuration of the note type</td></tr>
    <tr><td>visibility</td><td>string</td><td>The visibility of the note (e.g., "private", "public")</td></tr>
    <tr><td>attachments</td><td>array</td><td>Array of file attachments for the note</td></tr>
    <tr><td>author</td><td>string</td><td>Name of the note author</td></tr>
    <tr><td>authorId</td><td>string</td><td>ID of the note author</td></tr>
    <tr><td>authorEmail</td><td>string</td><td>Email of the note author</td></tr>
    <tr><td>metadata</td><td>object</td><td>Additional metadata for the note</td></tr>
    <tr><td>createdAt</td><td>string (ISO8601)</td><td>Creation timestamp</td></tr>
    <tr><td>updatedAt</td><td>string (ISO8601)</td><td>Last update timestamp</td></tr>
  </tbody>
</table>

### Sample response

```json theme={null}
{
  "data": [
    {
      "id": "NOTE001",
      "accountId": "ACC001",
      "account": "Acme Corporation",
      "content": "Customer has been experiencing intermittent issues over the past month. Consider upgrading their account to premium support tier for better monitoring.",
      "type": "Internal",
      "typeId": "TYPE001",
      "typeConfiguration": {
        "id": "TYPE001",
        "name": "Internal",
        "color": "#3B82F6"
      },
      "visibility": "private",
      "attachments": [
        {
          "id": "ATTACH001",
          "fileName": "performance_report.pdf",
          "fileSize": 1024000,
          "fileType": "application/pdf",
          "url": "https://example.com/files/performance_report.pdf"
        }
      ],
      "author": "John Doe",
      "authorId": "USER001",
      "authorEmail": "john.doe@company.com",
      "metadata": {
        "priority": "high",
        "tags": ["performance", "support"]
      },
      "createdAt": "2025-07-24T07:19:10.258Z",
      "updatedAt": "2025-07-24T07:19:10.258Z"
    },
    {
      "id": "NOTE002",
      "accountId": "ACC001",
      "account": "Acme Corporation",
      "content": "Follow-up call scheduled for next week to discuss the new feature requirements.",
      "type": "Customer",
      "typeId": "TYPE002",
      "typeConfiguration": {
        "id": "TYPE002",
        "name": "Customer",
        "color": "#10B981"
      },
      "visibility": "public",
      "attachments": [],
      "author": "Jane Smith",
      "authorId": "USER002",
      "authorEmail": "jane.smith@company.com",
      "metadata": {
        "priority": "medium",
        "tags": ["follow-up", "requirements"]
      },
      "createdAt": "2025-07-24T08:19:10.258Z",
      "updatedAt": "2025-07-24T08:19:10.258Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 2,
    "totalPages": 1
  },
  "status": true,
  "message": "Account notes retrieved successfully!",
  "timestamp": "2025-07-25T12:50:38.937Z"
}
```

<Admonition type="tip">
  Always pass an object as input, even if empty, to avoid errors when calling the tool directly.
</Admonition>

***
