> ## Documentation Index > Fetch the complete documentation index at: https://docs.devtune.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Audit findings > Returns the bounded finding rollup used by the Audit surface. Arbitrary date ranges are not accepted. affectedUrls is a capped sample; affectedPageCount reports the uncapped population the audit measured, in the unit named by affectedScope, and is null when a finding covers no countable population. ## OpenAPI ````yaml /openapi.json get /projects/{projectId}/audit/findings openapi: 3.1.0 info: title: DevTune API version: 2.0.0 description: >- API for programmatic access to your AI visibility data, webhook subscriptions, and automation workflows. Use this API to integrate DevTune data into CI/CD pipelines, BI tools, AI agents, and operational systems. servers: - url: https://devtune.ai/api/v2 description: Production security: - bearerAuth: [] paths: /projects/{projectId}/audit/findings: get: summary: List Audit findings description: >- Returns the bounded finding rollup used by the Audit surface. Arbitrary date ranges are not accepted. affectedUrls is a capped sample; affectedPageCount reports the uncapped population the audit measured, in the unit named by affectedScope, and is null when a finding covers no countable population. operationId: listAuditFindings parameters: - name: projectId in: path required: true schema: type: string format: uuid - name: includeDismissed in: query schema: type: boolean default: false - name: offset in: query schema: type: integer minimum: 0 default: 0 - name: pageSize in: query schema: type: integer minimum: 1 maximum: 100 default: 25 description: Results per page. Capped at 100. responses: '200': description: Audit findings content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/AuditFindingsData' meta: $ref: '#/components/schemas/Meta' required: - data - meta '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '403': $ref: '#/components/responses/ForbiddenError' '404': $ref: '#/components/responses/NotFoundError' '429': $ref: '#/components/responses/RateLimitExceededError' components: schemas: AuditFindingsData: type: object properties: sectionAssessments: type: object description: >- Published 30-day Audit section evidence. Includes status (available, unavailable, stale), publication time, independent page pagination and per-page complete, partial, unavailable, stale or failed assessments. Assessments retain version, source content hash, input hash, assessment time, bounded selected sections with Markdown offsets and exact source excerpts, and at most three advisory findings. Locked-page editing remedies are replaced with guidance to leave the page unchanged and consider separate supporting content. No numerical score or citation-effect claim. properties: status: type: string enum: - available - unavailable - stale publishedAt: type: - string - 'null' format: date-time refreshId: type: - string - 'null' windowDays: type: integer enum: - 30 items: type: array maxItems: 100 items: type: object properties: domainCanonical: type: string pagePath: type: string status: type: string enum: - complete - partial - unavailable - stale - failed assessment: anyOf: - $ref: '#/components/schemas/CitabilitySectionAssessment' - type: 'null' required: - domainCanonical - pagePath - status - assessment pagination: type: object properties: offset: type: integer minimum: 0 pageSize: type: integer minimum: 1 maximum: 100 hasMore: type: boolean required: - offset - pageSize - hasMore required: - status - publishedAt - refreshId - windowDays - items - pagination items: type: array items: $ref: '#/components/schemas/FlexibleRollupItem' pagination: $ref: '#/components/schemas/OffsetPagination' required: - items - pagination - sectionAssessments Meta: type: object properties: timestamp: type: string format: date-time projectId: type: string format: uuid CitabilitySectionAssessment: type: object properties: version: type: string contentHash: type: string minLength: 1 inputHash: type: string minLength: 1 assessedAt: type: string format: date-time status: type: string enum: - complete - partial - unavailable - failed reason: type: - string - 'null' enum: - no_substantive_sections - model_failure - invalid_excerpts - null selection: type: object properties: scannedChars: type: integer minimum: 0 sourceChars: type: integer minimum: 0 candidateCount: type: integer minimum: 0 sampled: type: boolean truncated: type: boolean required: - scannedChars - sourceChars - candidateCount - sampled - truncated additionalProperties: false sections: type: array maxItems: 6 items: type: object properties: locator: type: string maxLength: 100 heading: type: string maxLength: 200 start: type: integer minimum: 0 end: type: integer minimum: 0 source: type: string maxLength: 2000 truncated: type: boolean required: - locator - heading - start - end - source - truncated additionalProperties: false findings: type: array maxItems: 3 items: type: object properties: locator: type: string maxLength: 100 kind: type: string enum: - subject_clarity - direct_answer - evidence_proximity - conditions_or_limitations excerpt: type: string minLength: 1 maxLength: 600 explanation: type: string minLength: 1 maxLength: 400 remedy: type: string maxLength: 400 required: - locator - kind - excerpt - explanation - remedy additionalProperties: false required: - version - contentHash - inputHash - assessedAt - status - reason - selection - sections - findings additionalProperties: false FlexibleRollupItem: type: object additionalProperties: true description: >- A projected row from the same bounded rollup used by the corresponding DevTune application surface. OffsetPagination: type: object properties: hasMore: type: boolean offset: type: integer minimum: 0 pageSize: type: integer minimum: 1 maximum: 100 totalCount: type: integer minimum: 0 required: - hasMore - offset - pageSize - totalCount Error: type: object properties: error: type: string message: type: string status: type: integer required: - error - message - status responses: BadRequestError: description: Bad request content: application/json: schema: $ref: '#/components/schemas/Error' UnauthorizedError: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' ForbiddenError: description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Error' NotFoundError: description: Not found content: application/json: schema: $ref: '#/components/schemas/Error' RateLimitExceededError: description: Rate limit exceeded headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/Error' headers: X-RateLimit-Limit: description: Maximum requests per window schema: type: integer X-RateLimit-Remaining: description: Requests remaining in current window schema: type: integer X-RateLimit-Reset: description: Unix timestamp when the window resets schema: type: integer securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.