# List comments

Retrieve all comments for a project's budget

Endpoint: GET /projects/{projectId}/comments
Version: 1.0.0
Security: ApiKeyAuth

## Path parameters:

  - `projectId` (string, required)
    Project identifier (alias or ID)
    Example: "nike-spring-2024"

## Query parameters:

  - `accountId` (string)
    Filter comments by account ID or code
    Example: "2150"

  - `lineId` (string)
    Filter comments by budget line ID or alias
    Example: "line-001"

  - `idMode` (string)
    ID interpretation mode. Controls how path and query parameter IDs (like lineId, accountId, phaseId) are interpreted - 'user' for human-readable IDs (account codes, phase names), 'system' for database IDs (UUIDs/nanoids). Also affects the format of IDs in responses.
    Enum: "user", "system"

## Response 200 fields (application/json):

  - `comments` (array)

  - `comments.id` (string, required)
    Comment identifier
    Example: "comment-abc123"

  - `comments.content` (string, required)
    Comment content (HTML or plain text)
    Example: "<p>We need to adjust the lighting budget for the night shoot.</p>"

  - `comments.accountId` (string,null)
    Associated account ID
    Example: "account-marketing-01"

  - `comments.lineId` (string,null)
    Associated budget line ID
    Example: "line-item-456"

  - `comments.author` (object, required)

  - `comments.author.id` (string)
    Author user ID
    Example: "user-789"

  - `comments.author.name` (string)
    Author display name
    Example: "Jane Producer"

  - `comments.author.email` (string)
    Author email
    Example: "jane.producer@sunsetstudios.com"

  - `comments.createdAt` (string, required)
    Comment creation timestamp
    Example: "2024-03-18T16:00:00Z"

  - `comments.updatedAt` (string)
    Comment last update timestamp
    Example: "2024-03-19T16:00:00Z"

## Response 401 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (object)
    Additional error details
    Example: {"field":"projectId","reason":"Project not found"}

  - `code` (string)
    Error code
    Example: "VALIDATION_ERROR"

## Response 404 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (object)
    Additional error details
    Example: {"field":"projectId","reason":"Project not found"}

  - `code` (string)
    Error code
    Example: "VALIDATION_ERROR"

## Response 500 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (object)
    Additional error details
    Example: {"field":"projectId","reason":"Project not found"}

  - `code` (string)
    Error code
    Example: "VALIDATION_ERROR"