> ## Documentation Index > Fetch the complete documentation index at: https://docs.canary.effectiveai.app/llms.txt > Use this file to discover all available pages before exploring further. # List filing comments > Read the filing annotation timeline, including native filing workspace discussions, replies, status events, and deletion tombstones. Ordered by comment creation time and ID ascending. Requires filing read access. Status filters the current thread state. Limit defaults to 50 (maximum 100). The cursor binds caller, filing, status and limit for 24 hours from the first page. Reauthorize every page; this is a live list, not a snapshot. Historical targets remain attached to their original record/version; reading comments does not grant file access. ## OpenAPI ````yaml /openapi.json get /managed-filings/{filingId}/comments openapi: 3.0.3 info: title: Effective API version: 2.0.0 description: The public Effective REST API. Authenticate using an Effective API key. servers: - url: https://canary.effectiveai.app/api/v2 description: Canary security: - bearerAuth: [] paths: /managed-filings/{filingId}/comments: get: tags: - Managed Filings summary: List filing comments description: >- Read the filing annotation timeline, including native filing workspace discussions, replies, status events, and deletion tombstones. Ordered by comment creation time and ID ascending. Requires filing read access. Status filters the current thread state. Limit defaults to 50 (maximum 100). The cursor binds caller, filing, status and limit for 24 hours from the first page. Reauthorize every page; this is a live list, not a snapshot. Historical targets remain attached to their original record/version; reading comments does not grant file access. operationId: listManagedFilingComments parameters: - schema: type: string format: uuid required: true name: filingId in: path - schema: type: integer minimum: 1 maximum: 100 default: 50 required: false name: limit in: query - schema: type: string minLength: 1 maxLength: 128 required: false name: cursor in: query - schema: type: string enum: - open - resolved required: false name: status in: query responses: '200': description: Comment timeline page. content: application/json: schema: type: object properties: comments: type: array items: $ref: '#/components/schemas/V2ManagedFilingComment' nextCursor: type: string nullable: true description: Cursor for the next page, or null on the last page. required: - comments - nextCursor additionalProperties: false '400': description: Invalid request or invalid/expired cursor. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '401': description: Authentication required. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '403': description: Credential or Mission Control access denied. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '404': description: Resource missing or not visible. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '500': description: Unexpected server error. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '503': description: Dependency temporarily unavailable. Respect Retry-After. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' security: - bearerAuth: [] components: schemas: V2ManagedFilingComment: type: object properties: id: type: string threadId: type: string parentCommentId: type: string nullable: true commentType: type: string enum: - message - system - status_change actor: type: string body: type: string nullable: true data: type: object additionalProperties: nullable: true deleted: type: boolean editedAt: type: string nullable: true createdAt: type: string status: type: string enum: - open - resolved description: Resolution state of the whole annotation thread. anchor: $ref: '#/components/schemas/ResourceAnchor' target: $ref: '#/components/schemas/V2ManagedFilingCommentTarget' required: - id - threadId - parentCommentId - commentType - actor - body - data - deleted - editedAt - createdAt - status V2CodedError: allOf: - $ref: '#/components/schemas/V2Error' - type: object properties: code: type: string minLength: 1 description: Stable error code. Clients must tolerate unknown future codes. details: type: array items: type: object properties: location: type: string enum: - path - query - header - body path: type: array items: type: string maxLength: 64 maxItems: 12 code: type: string enum: - required - invalid_type - invalid_value - unknown_field message: type: string minLength: 1 maxLength: 200 required: - location - path - code - message minItems: 1 maxItems: 20 description: Bounded safe validation issues; may omit some invalid fields. requestId: type: string minLength: 1 maxLength: 128 description: >- Existing server correlation for this HTTP attempt, when available. required: - code ResourceAnchor: oneOf: - type: object properties: type: type: string enum: - whole_resource required: - type - type: object properties: type: type: string enum: - field path: type: string minLength: 1 required: - type - path description: Structural location within a resource V2ManagedFilingCommentTarget: oneOf: - type: object properties: type: type: string enum: - record recordType: type: string enum: - filings - filing_items - submissions - submission_items - objections - objection_items recordId: type: string format: uuid field: type: string pattern: ^[A-Za-z0-9_-]{1,128}$ required: - type - recordType - recordId additionalProperties: false - type: object properties: type: type: string enum: - artifact recordType: type: string enum: - filing_items - submission_items recordId: type: string format: uuid artifactId: type: string format: uuid artifactVersionId: type: string format: uuid description: >- Immutable Vault version UUID. Discover it through the existing artifact versions API. required: - type - recordType - recordId - artifactId - artifactVersionId additionalProperties: false description: >- Present on API-created discussions, inherited by replies. Older native discussions use anchor instead. V2Error: type: object properties: error: type: string minLength: 1 description: Human-readable explanation of the failure. required: - error securitySchemes: bearerAuth: type: http scheme: bearer description: 'Effective API key. Send Authorization: Bearer sk-eai-...' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.