> ## Documentation Index > Fetch the complete documentation index at: https://docs.emergence.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get violation > Get a single violation snapshot by its ID. ## OpenAPI ````yaml /openapi/em-data-readiness-v2.yaml get /api/data-readiness/violations/{violation_id} openapi: 3.1.0 info: title: EM Data Readiness Service description: Data Readiness Service API for managing workflows, metrics, and data quality version: 4.3.0-dev1 servers: [] security: - BearerAuth: [] tags: - name: Health description: Service health monitoring. Check service status and version information. - name: Root description: Root endpoint providing service information and navigation links. - name: Configuration description: Service configuration endpoints. View current configuration values. - name: Workflows description: >- Workflow configuration and execution management. Create, configure, and run data quality workflows including definitions, configurations, runs, and tasks. - name: Data Assets description: >- Data catalog entity management. Manage databases, schemas, and tables metadata. - name: Metrics description: >- Data quality metrics and scorecards. Calculate scores, view trends, and analyze dimensions. - name: Violations description: >- Data quality violation management. View, acknowledge, and remediate detected violations. - name: Glossary description: >- Business glossary management. Create, verify, and organize business terms and definitions. paths: /api/data-readiness/violations/{violation_id}: get: tags: - Violations summary: Get violation description: Get a single violation snapshot by its ID. operationId: get_violation parameters: - name: violation_id in: path required: true schema: type: string format: uuid description: Violation ID title: Violation Id description: Violation ID responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ViolationResponse' '404': description: Violation not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '410': description: Violation's parent dataset has been deleted content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - BearerAuth: [] components: schemas: ViolationResponse: properties: id: type: string format: uuid title: Id description: Unique violation identifier examples: - 550e8400-e29b-41d4-a716-446655440010 name: type: string title: Name description: Violation type name examples: - missing_description display_name: anyOf: - type: string - type: 'null' title: Display Name description: Human-readable name examples: - Missing Description fqn: type: string title: Fqn description: Fully qualified name examples: - violations.missing_description dimension: $ref: '#/components/schemas/DimensionRef' description: Reference to the assessment dimension service: type: string title: Service description: Data service name examples: - production_db database: anyOf: - type: string - type: 'null' title: Database description: Database name examples: - analytics schema: anyOf: - type: string - type: 'null' title: Schema description: Schema name examples: - public table: anyOf: - type: string - type: 'null' title: Table description: Table name examples: - customers column: anyOf: - type: string - type: 'null' title: Column description: Column name examples: - email asset_fqn: type: string title: Asset Fqn description: Fully qualified name of the asset examples: - production_db.analytics.public.customers.email asset_version: type: string title: Asset Version description: Version of the asset examples: - v1.0.0 severity: type: string title: Severity description: Violation severity examples: - high status: type: string title: Status description: Current violation status examples: - open details: anyOf: - additionalProperties: true type: object - type: 'null' title: Details description: Additional violation details examples: - actual: 'null' expected: not_null workflow_run_id: type: string format: uuid title: Workflow Run Id description: ID of the workflow run that detected this violation examples: - 550e8400-e29b-41d4-a716-446655440012 dq_rule_execution_id: anyOf: - type: string format: uuid - type: 'null' title: Dq Rule Execution Id description: Link to DQ rule execution (nullable) resolved_by: anyOf: - type: string - type: 'null' title: Resolved By description: Username who resolved the violation examples: - admin resolution_notes: anyOf: - type: string - type: 'null' title: Resolution Notes description: Notes about the resolution examples: - Added missing description to column created_at: type: string title: Created At description: When the violation was created examples: - '2024-01-15T10:30:00Z' type: object required: - id - name - fqn - dimension - service - asset_fqn - asset_version - severity - status - workflow_run_id - created_at title: ViolationResponse description: Response model for a single violation snapshot. ErrorResponse: properties: error: $ref: '#/components/schemas/ErrorInfo' description: >- Error information object containing code, message, and optional details request_id: anyOf: - type: string - type: 'null' title: Request Id description: Request ID for debugging and support examples: - req_abc123xyz type: object required: - error title: ErrorResponse description: >- Standard error response model for API errors. Matches the structure returned by _handle_service_error in workflows/routes.py. The actual API response format is: { "error": { "code": "ERROR_CODE", "message": "Error message", "details": {...} }, "request_id": "optional-request-id" } HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError DimensionRef: properties: id: type: string format: uuid title: Id description: Unique dimension identifier examples: - 550e8400-e29b-41d4-a716-446655440011 name: type: string title: Name description: Dimension name examples: - accuracy display_name: anyOf: - type: string - type: 'null' title: Display Name description: Human-readable name examples: - Accuracy assessment_type: type: string title: Assessment Type description: 'Type of assessment: ''metadata'' or ''data_quality''' examples: - data_quality type: object required: - id - name - assessment_type title: DimensionRef description: Lightweight reference to a dimension (for violation responses only). ErrorInfo: properties: code: type: string title: Code description: >- Error code identifier (e.g., 'WORKFLOW_NOT_FOUND', 'VALIDATION_ERROR') examples: - WORKFLOW_NOT_FOUND message: type: string title: Message description: Human-readable error message examples: - >- Workflow configuration with id '123e4567-e89b-12d3-a456-426614174000' not found details: anyOf: - additionalProperties: true type: object - type: 'null' title: Details description: >- Additional error details as a dictionary (flexible structure for business logic errors) examples: - workflow_id: 123e4567-e89b-12d3-a456-426614174000 type: object required: - code - message title: ErrorInfo description: >- Nested error information object. Note: This model uses an untyped dict for `details` to match the flexible error structure used throughout the service layer (see WorkflowServiceError and similar). This is distinct from ErrorDetail, which is used for structured validation errors. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- JWT Bearer token authentication. Include the token in the Authorization header as: `Authorization: Bearer `. The JWT must contain valid client_id, and project_id claims for tenant isolation and SDK routing. ````