API Documentation

Integrate CSV validation into your applications with our REST API or MCP server.

Authentication

API requests require a Bearer token. Include your token in the Authorization header of each request.

Authorization: Bearer YOUR_API_TOKEN

Validate a CSV File

Upload a CSV file for validation. The file is processed and results are returned immediately.

POST /api/v1/csv-validator/process

Request parameters:

Parameter	Type	Description
`csv_file`	file	The CSV file to validate (required, max 10MB)

Response Format

{
  "success": true,
  "file_name": "data.csv",
  "file_size": "2.4 KB",
  "share_token": "abc123...",
  "share_url": "https://csv.example.com/csv-validator/abc123",
  "results": {
    "encoding": "UTF-8",
    "delimiter": ",",
    "has_header": true,
    "total_rows": 150,
    "total_columns": 8,
    "quality_score": 92,
    "issues": [],
    "headers": ["id", "name", "email", ...],
    "column_types": {"id": "integer", "name": "string", ...}
  }
}

Get Validation Result

GET /api/v1/csv-validator/{token}

Retrieve a previously generated validation result by its share token.

MCP Server (Model Context Protocol)

Our MCP server allows AI agents and LLMs to discover and use the CSV validation tool programmatically. Send tool discovery and call requests to the MCP endpoints.

POST /api/mcp/tools/list
POST /api/mcp/tools/call

Rate Limits

Free anonymous users get 100 validations per day. API token holders get higher limits based on their plan. Rate limit headers are included in every response.