> ## Documentation Index > Fetch the complete documentation index at: https://ancplua.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Get apiv1errors > List error groups ## OpenAPI ````yaml /api-reference/openapi.yaml get /api/v1/errors openapi: 3.0.0 info: title: QYL Observability API version: '2026-01-26' servers: - url: https://api.staging.qyl.dev description: QYL Staging API variables: {} - url: https://api.qyl.dev description: QYL Production API variables: {} security: [] tags: - name: Streaming - name: Traces - name: Logs - name: Metrics - name: Sessions - name: Errors - name: Deployments - name: Services - name: Health - name: Workspaces - name: Onboarding - name: Configurator - name: Issues - name: Workflows - name: Search - name: Alerts paths: /api/v1/errors: get: tags: - Errors description: List error groups operationId: ErrorsApi_list parameters: - name: serviceName in: query required: false description: Service name filter schema: type: string explode: false - name: status in: query required: false description: Status filter schema: $ref: '#/components/schemas/Qyl.Domains.Observe.Error.ErrorStatus' explode: false - name: category in: query required: false description: Category filter schema: $ref: '#/components/schemas/Qyl.Domains.Observe.Error.ErrorCategory' explode: false - name: startTime in: query required: false description: Start time schema: type: string format: date-time explode: false - name: endTime in: query required: false description: End time schema: type: string format: date-time explode: false - name: limit in: query required: false description: Page size schema: type: integer format: int32 minimum: 1 maximum: 1000 default: 100 explode: false - name: cursor in: query required: false description: Cursor schema: type: string explode: false responses: '200': description: The request has succeeded. content: application/json: schema: type: object required: - items - has_more properties: items: type: array items: $ref: >- #/components/schemas/Qyl.Domains.Observe.Error.ErrorEntity description: List of items in this page next_cursor: type: string description: Cursor for the next page (null if no more pages) prev_cursor: type: string description: Cursor for the previous page (null if first page) has_more: type: boolean description: Whether there are more items available description: Cursor-based paginated response wrapper '400': description: Bad request - validation failed (400) headers: X-Trace-Id: required: false description: Trace ID for correlation schema: type: string X-Request-Id: required: false description: Request ID for support schema: type: string content: application/json: schema: $ref: '#/components/schemas/Qyl.Common.Errors.ValidationError' '500': description: Internal server error (500) headers: X-Trace-Id: required: false description: Trace ID for correlation schema: type: string X-Request-Id: required: false description: Request ID for support schema: type: string content: application/json: schema: $ref: '#/components/schemas/Qyl.Common.Errors.InternalServerError' components: schemas: Qyl.Domains.Observe.Error.ErrorStatus: type: string enum: - new - acknowledged - in_progress - resolved - ignored - regressed - wont_fix description: Error tracking status Qyl.Domains.Observe.Error.ErrorCategory: type: string enum: - client - server - network - timeout - validation - authentication - authorization - rate_limit - not_found - conflict - internal - external - database - configuration - unknown description: High-level error categories Qyl.Domains.Observe.Error.ErrorEntity: type: object required: - error_id - error.type - message - category - fingerprint - first_seen - last_seen - occurrence_count - status properties: error_id: type: string description: Error ID error.type: type: string description: Error type (class name or code) message: type: string description: Error message category: allOf: - $ref: '#/components/schemas/Qyl.Domains.Observe.Error.ErrorCategory' description: Error category fingerprint: type: string description: Fingerprint for grouping first_seen: type: string format: date-time description: First occurrence last_seen: type: string format: date-time description: Last occurrence occurrence_count: allOf: - $ref: '#/components/schemas/Qyl.Common.Count' description: Occurrence count affected_users: allOf: - $ref: '#/components/schemas/Qyl.Common.Count' description: Affected users count affected_services: type: array items: type: string description: Affected services status: allOf: - $ref: '#/components/schemas/Qyl.Domains.Observe.Error.ErrorStatus' description: Status assigned_to: type: string description: Assigned to issue_url: allOf: - $ref: '#/components/schemas/Qyl.Common.UrlString' description: Issue tracker URL sample_traces: type: array items: $ref: '#/components/schemas/Qyl.Common.TraceId' description: Sample trace IDs description: Error entity for tracking and analysis x-csharp-type: ErrorEntity x-duckdb-table: errors Qyl.Common.Errors.ValidationError: type: object required: - title - errors properties: title: type: string enum: - Validation Failed errors: type: array items: $ref: '#/components/schemas/Qyl.Common.Errors.ValidationErrorDetail' description: List of validation errors allOf: - $ref: '#/components/schemas/Qyl.Common.Errors.ProblemDetails' description: Bad request - validation failed (400) Qyl.Common.Errors.InternalServerError: type: object required: - title properties: title: type: string enum: - Internal Server Error error_code: type: string description: Error code for support reference allOf: - $ref: '#/components/schemas/Qyl.Common.Errors.ProblemDetails' description: Internal server error (500) Qyl.Common.Count: type: integer format: int64 minimum: 0 description: Generic non-negative counter x-csharp-type: long x-duckdb-type: BIGINT Qyl.Common.UrlString: type: string format: uri description: URL string (absolute) Qyl.Common.TraceId: type: string minLength: 32 maxLength: 32 pattern: ^[a-f0-9]{32}$ description: Unique trace identifier (32 lowercase hex characters) example: 0af7651916cd43dd8448eb211c80319c x-csharp-type: TraceId x-csharp-struct: true x-duckdb-type: VARCHAR(32) Qyl.Common.Errors.ValidationErrorDetail: type: object required: - field - message - code properties: field: type: string description: The field/property that failed validation message: type: string description: The error message code: type: string description: The validation rule that failed rejected_value: type: string description: The rejected value (if safe to include) description: Individual validation error detail Qyl.Common.Errors.ProblemDetails: type: object required: - type - title - status properties: type: type: string format: uri description: A URI reference identifying the problem type default: about:blank title: type: string description: A short, human-readable summary of the problem type status: type: integer format: int32 description: >- The HTTP status code (informational only, actual code set by subtype) detail: type: string description: A human-readable explanation specific to this occurrence instance: type: string format: uri description: A URI reference identifying the specific occurrence timestamp: type: string format: date-time description: Timestamp of the error description: RFC 7807 Problem Details for HTTP APIs ````