> ## Documentation Index > Fetch the complete documentation index at: https://altostrat.io/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Generated Reports > Retrieves a paginated list of all historically generated reports for the workspace, sorted by creation date in descending order. ## OpenAPI ````yaml /api/en/reports.yaml get /reports/sla/reports openapi: 3.0.3 info: title: Altostrat Reports API version: 1.0.0 description: >- The Altostrat Reports API is the microservice responsible for scheduling, generating, and storing comprehensive Service Level Agreement (SLA) and network performance reports. It provides historical insights and accountability for network uptime by consuming fault data from across the Altostrat SDX platform and transforming it into scheduled, human-readable PDF reports. This API allows you to programmatically manage: - **SLA Report Schedules:** The core configuration object defining what data to collect, for which sites, and on what schedule (daily, weekly, monthly). - **Generated Reports:** The immutable, historical artifacts produced by a schedule run, including a detailed breakdown of site uptime and a downloadable PDF. Developers use this API to automate the creation of SLA report configurations and retrieve the resulting performance data for integration into dashboards or third-party systems. servers: - url: https://v1.api.altostrat.io description: Altostrat Production API security: [] tags: - name: SLA Report Schedules description: Manage the configuration of automated SLA reports. - name: Generated Reports description: Access and manage historically generated report results. paths: /reports/sla/reports: get: tags: - Generated Reports summary: List Generated Reports description: >- Retrieves a paginated list of all historically generated reports for the workspace, sorted by creation date in descending order. operationId: listGeneratedReports parameters: - name: page in: query description: The page number to retrieve. schema: type: integer default: 1 - name: per_page in: query description: The number of items to retrieve per page. schema: type: integer default: 10 responses: '200': description: A paginated list of generated reports. content: application/json: schema: $ref: '#/components/schemas/PaginatedGeneratedReports' '500': description: Internal Server Error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - BearerAuth: [] components: schemas: PaginatedGeneratedReports: type: object properties: data: type: array items: $ref: '#/components/schemas/GeneratedReport' links: type: object properties: first: type: string format: uri nullable: true last: type: string format: uri nullable: true prev: type: string format: uri nullable: true next: type: string format: uri nullable: true meta: type: object properties: current_page: type: integer from: type: integer nullable: true last_page: type: integer path: type: string format: uri per_page: type: integer to: type: integer nullable: true total: type: integer ErrorResponse: type: object properties: type: type: string description: A broad category for the error (e.g., 'invalid_request_error'). example: invalid_request_error code: type: string description: A short, unique string identifying the specific error. example: parameter_missing message: type: string description: A human-readable description of what went wrong. example: The 'name' parameter is required for this request. doc_url: type: string description: >- A direct link to the documentation page for this specific error code. example: https://docs.altostrat.io/errors/parameter_missing GeneratedReport: type: object description: Metadata and links for a completed report. properties: id: type: string description: The ID of the schedule that generated this report. example: sla_2ayc4Yy6w3g7Y2j4g4g4Yy6w3g7 report_id: type: string description: >- The unique, human-friendly identifier for this specific report instance. example: BCDF-GHJK name: type: string description: The name of the report schedule at the time of generation. example: Monthly Executive SLA Summary start_date: type: string format: date-time description: The start of the reporting period. end_date: type: string format: date-time description: The end of the reporting period. created_at_date: type: string format: date-time description: The timestamp when the report was generated. sla_target: type: number format: float description: The SLA target percentage for this report. example: 99.95 downtime_percentage_all_hours: type: number format: float description: >- The average downtime percentage across all sites, calculated over 24/7. example: 0.12 downtime_percentage_business_hours: type: number format: float description: >- The average downtime percentage across all sites, calculated only within defined business hours. example: 0.05 site_count: type: integer description: The number of sites included in this report. example: 42 business_hour_id: type: string format: uuid description: The ID of the business hours schedule used, if any. business_hour_name: type: string description: The name of the business hours schedule used, if any. business_hour_timezone: type: string description: The timezone of the business hours schedule used, if any. shared_url: type: string format: uri description: A direct, public URL to download the generated PDF report. json_url: type: string format: uri description: A direct, public URL to download the raw JSON data for the report. timestamp: type: integer format: int64 description: The Unix timestamp of when the report was generated. securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: Enter your authentication token. ````