# CrateAPI

> The format layer for EU e-invoicing: generate, validate, convert and
> render EN 16931 documents (Factur-X, UBL/Peppol BIS, XRechnung, CII),
> plus a small utility API portfolio (PDF, screenshot, email validation,
> content extraction). CrateAPI is not a transmission pipe or a Peppol
> Access Point - it produces and checks compliant documents; sending them
> is your channel (your PA, your ERP, your integration).

## E-Invoicing API

Base URL: `https://api.crateapi.com/v1`
Auth: header `X-API-Key: <your key>` (get one at https://crateapi.com/#pricing)
Free, no key needed: `/validate/ubl`, `/validate/cii`, `/pdfa/validate`

Key endpoints (all `POST` unless noted):
- `/validate/{ubl,cii}?profile=...` - free, structured report (rule id, severity, message)
- `/repair/{ubl,cii}?profile=...` - fixes non-ISO dates + totals arithmetic drift, never invents missing data
- `/generate/{ubl,cii,facturx}` - JSON invoice model in, compliant document out
- `/convert/{ubl-to-cii,cii-to-ubl}` - lossless-or-rejected (422 with details, never a silent degrade)
- `/render/{html,pdf}` - invoice XML in, human-readable output
- `/pdfa/{convert,validate}` - PDF/A-3 archival
- `GET /openapi.json`, `GET /docs` - full machine-readable API spec (Swagger UI)
- `GET /validator` - free drag-and-drop validator in the browser, no signup

Profiles: en16931, peppol, xrechnung, ro (RO CIUS), fr / fr-extended (France BR-FR/AFNOR).

Pricing: Free (unlimited validate + 50 generated docs/month, watermarked) /
$29 per 500 invoices/month / $79 per 2,500/month / $199 per 10,000/month.
Full pricing: https://crateapi.com/#pricing

MCP server (self-hosted, works today with your own API key):
```json
{"mcpServers": {"crateapi-einvoicing": {
    "command": "python", "args": ["-m", "einvoicing.mcp_server"],
    "env": {"EINVOICE_API_KEY": "your-key-here"}}}}
```
Tools: validate_invoice (free), repair_invoice, generate_invoice, convert_invoice.

## Document Tools API (PDF / Screenshot / Email / Extract)

Base URL: `https://api.crateapi.com` (paths `/pdf`, `/screenshot`, `/email`, `/extract`)
Auth: via RapidAPI (listing pending) or contact for direct access.
Per-API OpenAPI specs: `/pdf/openapi.json`, `/screenshot/openapi.json`,
`/email/openapi.json`, `/extract/openapi.json`.

- PDF: merge, split, watermark, protect (AES-256), compress, to-images, extract-text, metadata
- Screenshot: URL to PNG/JPEG, full-page, block ads/trackers/cookie-banners, cache
- Email: syntax + MX + disposable + role-account + free-provider signals, single or bulk CSV upload
- Extract: article/content extraction from a URL, boilerplate removed

Pricing: Free (100 req/month) / $14.90 per 10,000 req/month / $39.90 per 50,000/month.

## Reference pages

- Full API reference (all endpoints, curl examples): https://crateapi.com/docs/
- Error code reference (1,900+ pages, human explanations for EN16931/Peppol/
  XRechnung/BR-FR validation rules, EN/FR/DE/RO): https://crateapi.com/errors/
- France pre-flight / Plateformes Agréées: https://crateapi.com/plateforme-agreee/
- EU e-invoicing mandate tracker (FR/DE/IT/RO dates + ViDA): https://crateapi.com/mandate-tracker/
- Comparison vs InvoiceXML: https://crateapi.com/compare/invoicexml/
- Live status/uptime: https://crateapi.com/status/
- Structured machine-readable summary of this file: https://crateapi.com/ai