Skip to content
Caso de clienteTarifasSeguridadComparativaBlog

Europe

Americas

Oceania

API & Integration

Integrate document validation into your applications

A simple yet powerful REST API to automate file validation from any business tool.

Integration in 3 steps

01

Send your documents

Call our endpoint with your files (PDF, images, scans). All formats accepted.

02

AI analyzes

CheckFile identifies file type, extracts data, cross-references documents, and checks compliance.

03

Get the verdict

Structured JSON response with status (compliant/non-compliant), anomaly details, and confidence scores.

API call example

Request
POST /api/v1/validate
Content-Type: multipart/form-data
Authorization: Bearer YOUR_API_KEY

{
  "file_type": "financing",
  "documents": [
    { "type": "contract", "file": "contract.pdf" },
    { "type": "identity", "file": "id_card.pdf" },
    { "type": "kbis", "file": "kbis.pdf" }
  ]
}
Response
{
  "status": "non_compliant",
  "confidence": 0.97,
  "anomalies": [
    {
      "type": "amount_mismatch",
      "severity": "high",
      "detail": "Contract amount (€15,200) ≠ Quote amount (€12,860)",
      "documents": ["contract.pdf", "quote.pdf"]
    }
  ],
  "processing_time_ms": 4200
}

Authentication

Header:Authorization: Bearer sk_live_...
Rate limit:100 req/min (Starter), 1,000/min (Business), unlimited (Enterprise)

Error codes

CodeDescription
400Bad request — missing parameters or incorrect format
401Missing or invalid API key
403Access denied — insufficient plan for this resource
422Unprocessable document — unsupported format or corrupted file
429Rate limit exceeded — retry after the indicated delay
500Server error — contact support if persistent

Webhook example

Receive a notification after each analysis.

POST https://your-domain.com/webhook
Content-Type: application/json
X-CheckFile-Signature: sha256=...

{
  "event": "analysis.completed",
  "file_id": "file_abc123",
  "status": "non_compliant",
  "anomalies_count": 2,
  "processing_time_ms": 4200,
  "created_at": "2025-01-15T10:30:00Z"
}

Batch upload

Process multiple files in a single call.

POST /api/v1/batch
Content-Type: application/json
Authorization: Bearer sk_live_...

{
  "files": [
    { "file_type": "financing", "documents": [...] },
    { "file_type": "insurance", "documents": [...] },
    { "file_type": "real_estate", "documents": [...] }
  ],
  "webhook_url": "https://your-domain.com/webhook"
}

API features

Multi-format

PDF, JPEG, PNG, TIFF, scans, photos. All document formats accepted.

Cross-analysis

Automatic consistency check across all documents in a file.

Webhooks

Real-time notifications on analysis completion. Event-driven integration.

Enrichment

Verification via official APIs: company registries, government databases.

Configurable rules

Define your own business rules per file type and per partner.

High availability

99.9% uptime, European hosting, AES-256 encryption in transit and at rest.

Connect CheckFile to your tools

Beyond the REST API, CheckFile connects natively to your everyday tools.

CRM

  • Salesforce
  • HubSpot
  • Pipedrive
  • Zoho

ERP & Accounting

  • SAP
  • Cegid
  • Sage
  • Pennylane

Automation

  • Zapier
  • Make
  • Webhooks

Storage

  • Google Drive
  • SharePoint
  • Dropbox
  • Box

Coming soon

Interactive documentation (Swagger)

Deployment in progress

Sandbox environment

Available on request

Python & Node.js SDKs

In development

Ready to integrate CheckFile?

Get your test API keys and start validating your files in minutes.