---
title: "List comments on a DIR"
method: GET
path: "/dir/{dir_id}/comments"
tags: ["Comments"]
---

# List comments on a DIR

`GET /dir/{dir_id}/comments`

List the comments on a DIR. The enterprise is resolved server-side from the DIR id.

## Path parameters

- `dir_id` string, uuid, required

## Query parameters

- `page[number]` integer
- `page[size]` integer
- `comment_type` 'vetting_comment' | 'rejection_reason' | 'internal_note' | 'notification' | 'status_update' | 'customer_inquiry' | 'admin_response' — Comment categorisation. Customers post `customer_inquiry`. The Telnyx team posts `vetting_comment`, `rejection_reason`, `notification`, `status_update`, or `admin_response`. `internal_note` is filtered out of customer-visible responses.

## Response `200`

Paginated list of comments.

- CommentList
  - `data` DirComment[], required
    - `id` string, uuid
    - `entity_type` 'dir' — Resource the comment is attached to. Always `dir` on this endpoint.
    - `content` string
    - `visibility` 'customer' — Always `customer` on this endpoint - internal-only comments are filtered out.
    - `author_role` 'customer' | 'admin' — Who wrote the comment. `admin` covers the Telnyx vetting team.
    - `author_name` string, nullable — Display name of the author. May be `null`.
    - `comment_type` 'vetting_comment' | 'rejection_reason' | 'internal_note' | 'notification' | 'status_update' | 'customer_inquiry' | 'admin_response' — Comment categorisation. Customers post `customer_inquiry`. The Telnyx team posts `vetting_comment`, `rejection_reason`, `notification`, `status_update`, or `admin_response`. `internal_note` is filtered out of customer-visible responses.
    - `created_at` string, date-time
  - `meta` BrandedCallingPaginationMeta, required — JSON:API pagination metadata returned with every paginated list response. Page numbering is 1-based. `page_size` reports the number of items actually returned in `data` for this page; the requested size is taken from the `page[size]` query parameter.
    - `total_pages` integer, required — Total number of pages available given the current `page_size`.
    - `total_results` integer, required — Total number of items across all pages (excludes soft-deleted rows).
    - `page_number` integer, required — 1-based index of this page. Echoes the `page[number]` query parameter (default `1`).
    - `page_size` integer, required — Number of items returned in this page's `data` array. Capped at 250.

## Other responses

- `default` — An error occurred. The response carries the standard Telnyx error envelope.
- `4XX` — An error occurred. The response carries the standard Telnyx error envelope.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)