---
title: "List conversation notes"
method: GET
path: "/v2/api/conversations/{contact_number}/notes"
tags: ["Notes"]
---

# List conversation notes

`GET /v2/api/conversations/{contact_number}/notes`

## Request

- Base URL: `https://api.withallo.com`
- URL: `https://api.withallo.com/v2/api/conversations/{contact_number}/notes`
- Auth: API key in header `Authorization`

Returns the internal team notes on a conversation, paginated.

## Path parameters

- `contact_number` string, required

## Query parameters

- `allo_number` string, required
- `page` integer
- `size` integer

## Response `200`

List of conversation notes

- object
  - `data` ConversationNote[]
    - `id` string: Note ID (`not-*`)
    - `content` string: Note text, with mentions inline as `@[Name](usr-...)`.
    - `contact_number` string: The contact's phone number (E.164).
    - `allo_number` string, nullable: The Allo line the conversation belongs to (E.164).
    - `user` NoteUser: Author of a note or comment.
      - `id` string
      - `name` string, nullable
    - `mentions` NoteMention[]
      - `user_id` string
      - `name` string, nullable
      - `deleted` boolean: `true` if the mentioned user has since been removed from the team.
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `pagination` Pagination
    - `page` integer
    - `size` integer
    - `total_count` integer
    - `total_pages` integer
    - `has_more` boolean

## Other responses

- `400`: Invalid request parameters
- `401`: Invalid or missing API key
- `403`: API key lacks the required scope or access to the resource
- `429`: Rate limit exceeded

## Changes

- **2026-11-03** `46c77103dd14`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/withallo/apis/allo-api/changes/v2/api/conversations/:contact_number/notes/get.md)

---

[API](https://skmtc.dev/withallo/apis/allo-api.md) - [All operations](https://skmtc.dev/withallo/apis/allo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withallo/apis/allo-api/revisions/46c77103dd14?raw)