---
title: "List Internal Notes"
method: GET
path: "/api/companies/{company_uuid}/internal-notes/"
tags: ["internal-notes"]
---

# List Internal Notes

`GET /api/companies/{company_uuid}/internal-notes/`

## Request

- Base URL: `https://api.regdoor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.regdoor.com/api/companies/{company_uuid}/internal-notes/`
- Auth: HTTP bearer

List internal notes for a specific company and parent entity.

Args:
- company_uuid: The UUID of the company

Filters:
- parent_pk: The primary key of the parent entity (id or UUID)
- mentioned_kind + mentioned_uuid: notes whose text mentions that entity

## Path parameters

- `company_uuid` string, uuid, required

## Query parameters

- `parent_pk` string, nullable: Filter by parent primary key
- `parent_type` 'Jurisdiction' | 'Organization' | 'Contact' | 'Interaction' | 'Project' | 'Event' | 'Task'
- `mentioned_kind` string, nullable: Entity mention kind in note text (e.g. contact, user)
- `mentioned_uuid` string, uuid, nullable: Entity UUID embedded in [[entity:kind:uuid|…]] tokens
- `page` integer: Page number
- `size` integer: Page size

## Headers

- `X-User-Email` string, nullable
- `X-User-Name` string, nullable

## Response `200`

Successful Response

- PageInternalNoteResponse
  - `items` InternalNoteResponse[], required
    - `uuid` string, uuid4, required
    - `parent_type` 'Jurisdiction' | 'Organization' | 'Contact' | 'Interaction' | 'Project' | 'Event' | 'Task', required
    - `parent_pk` string, required
    - `company_uuid` string, uuid4, required
    - `text` string, required
    - `created_by` UserBase, required
      - `uuid` string, uuid4, required
      - `name` string, required
      - `phone_number` string, nullable
      - `email` string, email, required
      - `avatar_file_name` string, nullable
      - `ui_language` 'en' | 'pt' | 'es', nullable
      - `avatar_url` string, nullable, required: Get the avatar URL based on the filename if one exists
    - `author_type` 'Human' | 'System', required: Who wrote the note. `SYSTEM` notes are automatic audit entries (e.g. a Task status-transition log) — they have no `created_by_uuid` and are, by construction, never editable/deletable via `update()`/`soft_delete()` since those check `created_by_uuid == current_user`.
    - `created_at` string, date-time, required
    - `attachments` InternalNoteAttachmentResponse[]
      - `uuid` string, uuid4, required
      - `internal_note_uuid` string, uuid4, required
      - `company_uuid` string, uuid4, required
      - `storage_filename` string, required
      - `original_filename` string, required
      - `content_type` string, required
      - `size_bytes` integer, nullable
      - `file_url` string, nullable
      - `created_at` string, date-time, required
  - `total` integer, nullable, required
  - `page` integer, nullable, required
  - `size` integer, nullable, required
  - `pages` integer, nullable

## Other responses

- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/regdoor/apis/regdoor-api.md) - [All operations](https://skmtc.dev/regdoor/apis/regdoor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/regdoor/apis/regdoor-api/revisions/7642336631af?raw)