Overview

Access a complete, searchable history of all validations performed. Filter by date range, schema type, validation status (pass/fail), and project to find specific results or track patterns.

How It Works

1. Every validation (URL, paste, bulk) is stored in history
2. Users can browse paginated results
3. Advanced filters: date range, schema type, status, project
4. Each entry links to the full validation report
5. History feeds into trends and analytics

Tier Availability

| Tier | History Retention |
|——|——————-|
| Free | No history |
| Pro | Full history |
| Agency | Full history |
| Enterprise | Full history |

Related Features

– Export CSV/PDF: Download history data
– Trends & Temporal Data: Visualize patterns from history

Mini-Tutorial

Step 1: Access History

Click “History” in the sidebar to view all validations for your account or project.

Step 2: Apply Filters

Use filters to narrow results:
– Date Range: e.g., “Last 7 days”
– Schema Type: e.g., “Product”
– Status: Valid, Invalid, Warning
– Project: Scope to a specific project

Step 3: Sort Results

Click column headers to sort by URL, date, or score. Most recent validations appear first by default.

Step 4: Drill Into Details

Click any validation to see the full report: exact errors, property coverage, and recommendations.

Step 5: Export for Audit

Use “Export as CSV” to create a complete record for compliance or stakeholder reporting.

Technical Details

Request

GET /api/v1/history?page=1&per_page=50&project_id=abc123&date_from=2025-01-01&date_to=2025-03-22&schema_type=Product&status=valid

Response Example

{
  "page": 1,
  "per_page": 50,
  "total": 342,
  "entries": [
    {
      "id": "val_12345",
      "url": "https://example.com/products/widget",
      "project_id": "proj_abc",
      "schema_type": "Product",
      "status": "valid",
      "score": 92,
      "errors": 0,
      "warnings": 1,
      "validated_at": "2025-03-22T14:30:00Z",
      "validated_by": "[email protected]"
    },
    {
      "id": "val_12344",
      "url": "https://example.com/blog/article-1",
      "project_id": "proj_abc",
      "schema_type": "Article",
      "status": "valid",
      "score": 85,
      "errors": 0,
      "warnings": 2,
      "validated_at": "2025-03-21T10:15:00Z",
      "validated_by": "plugin"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_page": 2
  }
}

Single Validation Detail

GET /api/v1/history/val_12345

Response includes full validation report with all errors, warnings, and property coverage details.

References

– OpenAPI 3.0 Pagination Best Practices
– REST API Filtering Conventions
– JSON Schema Specification
– ValidGraph History API Docs