> ## Documentation Index > Fetch the complete documentation index at: https://help.withallo.com/llms.txt > Use this file to discover all available pages before exploring further. # List person notes > Returns the notes on a person's CRM profile, paginated. **Required scope:** `NOTES_READ` Returns the notes on a person's CRM profile, paginated. `person_id` is the `per-*` `id` from the [People API](/en/v2/api-reference/crm/people-overview). ## Errors | Status | Code | When | | ------ | --------------------------- | ------------------------------------------------------------------------ | | `400` | `CONTACT_NOTES_UNAVAILABLE` | The workspace is not on the v2 contact model yet | | `400` | `INVALID_PAGE_SIZE` | `size` is not between 1 and 100 | | `404` | `PERSON_NOT_FOUND` | No person with this ID (also returned for IDs without the `per-` prefix) | ## OpenAPI ````yaml GET /v2/api/crm/people/{person_id}/notes openapi: 3.0.3 info: title: Allo API description: >- Allo API provides programmatic access to your Allo account, allowing you to manage webhooks, retrieve calls and contacts, and send SMS messages. All requests to `/v1/api/**` endpoints automatically go through quota checking and scope validation. version: 1.0.0 contact: name: Allo Support servers: - url: https://api.withallo.com description: Production server security: [] tags: - name: Summary Templates description: >- Manage call summary templates that control how AI-generated call summaries are structured for your team. - name: Webhooks description: >- Manage webhook endpoints to receive real-time notifications about events in your Allo account. Each endpoint subscribes to one or more event topics and is verified with a signing secret. - name: Calls description: >- Retrieve and search call records with filtering and pagination. Filter calls by your Allo phone number. - name: Contacts description: >- Search and retrieve contact information with sorting and pagination. Includes engagement level tracking. - name: SMS description: Send SMS messages to phone numbers using your Allo numbers. - name: Phone Numbers description: Retrieve information about your Allo phone numbers. - name: Analytics description: Pre-computed call metrics, team performance, and outbound dial funnel - name: CRM description: Manage people, companies, and deals in your CRM. - name: Notes description: >- Internal team notes on conversations and CRM people, with @mention support. Notes are never visible to the contact. - name: Threads description: >- Team discussion threads attached to a conversation item (call, SMS, or conversation note). One thread per item. paths: /v2/api/crm/people/{person_id}/notes: get: tags: - Notes summary: List person notes description: Returns the notes on a person's CRM profile, paginated. operationId: listPersonNotes parameters: - name: person_id in: path required: true description: Person ID (`per-*`) — the `id` field from the People API. schema: type: string example: per-abc123 - $ref: '#/components/parameters/Page' - $ref: '#/components/parameters/Size' responses: '200': description: List of person notes content: application/json: schema: allOf: - type: object properties: data: type: array items: $ref: '#/components/schemas/PersonNote' - $ref: '#/components/schemas/PaginatedResponse' example: data: - id: cno-abc123 person_id: per-abc123 content: >- Prefers email over calls. Intro by @[Jane Doe](usr-abc123). user: id: usr-def456 name: John Smith mentions: - user_id: usr-abc123 name: Jane Doe deleted: false created_at: '2026-07-13T10:00:00' updated_at: '2026-07-13T10:00:00' pagination: page: 1 size: 20 total_count: 1 total_pages: 1 has_more: false '400': $ref: '#/components/responses/ApiValidationError' '401': $ref: '#/components/responses/ApiUnauthorized' '404': $ref: '#/components/responses/ApiNotFound' '429': $ref: '#/components/responses/ApiRateLimited' security: - ApiKeyAuth: [] components: parameters: Page: name: page in: query description: Page number (1-indexed) schema: type: integer default: 1 minimum: 1 Size: name: size in: query description: Results per page schema: type: integer default: 20 minimum: 1 maximum: 100 schemas: PersonNote: type: object properties: id: type: string description: Note ID (`cno-*`) example: cno-abc123 person_id: type: string description: Person ID (`per-*`) example: per-abc123 content: type: string description: Note text, with mentions inline as `@[Name](usr-...)`. user: $ref: '#/components/schemas/NoteUser' mentions: type: array items: $ref: '#/components/schemas/NoteMention' created_at: type: string format: date-time updated_at: type: string format: date-time PaginatedResponse: type: object properties: pagination: $ref: '#/components/schemas/Pagination' NoteUser: type: object description: Author of a note or comment. properties: id: type: string example: usr-def456 name: type: string nullable: true example: John Smith NoteMention: type: object description: A user mentioned in the content via `@[Name](usr-...)`. properties: user_id: type: string example: usr-abc123 name: type: string nullable: true example: Jane Doe deleted: type: boolean description: '`true` if the mentioned user has since been removed from the team.' Pagination: type: object properties: page: type: integer size: type: integer total_count: type: integer total_pages: type: integer has_more: type: boolean ApiError: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string retryable: type: boolean request_id: type: string retry_after_seconds: type: integer nullable: true responses: ApiValidationError: description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiUnauthorized: description: Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiNotFound: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiRateLimited: description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ApiError' securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization ````