# VIESAC

> VIES VAT validation, compliance audits, downloadable certificates, and free EU VAT tools. Authenticated REST API v1 for programmatic checks and audit records.

VIESAC is a Laravel application: live site and API base **https://viesac.eu**. EU/EEA VAT checks use the official VIES (and related) flows; optional AI-assisted fallback when VIES is inconclusive. UK (GB) HMRC integration exists in code but may be **disabled in production** via `HMRC_VAT_ENABLED` — do not assume HMRC is available on the public host.

## Primary documentation

- [API documentation (human)](https://viesac.eu/api-docs): authentication, endpoints, examples, rate limits.
- [OpenAPI 3 specification](https://viesac.eu/openapi.yaml): machine-readable API for agents and integrations.

## REST API (v1)

All v1 routes are under **https://viesac.eu/api/v1/** and require header `Authorization: Bearer <api_key>`. Create API keys in the registered user dashboard (`/app`).

| Purpose | Method | Path |
|--------|--------|------|
| Quick VAT status (no audit row) | GET | `/api/v1/validate?vat=...` |
| Account / plan usage | GET | `/api/v1/account` |
| Create audit | POST | `/api/v1/audits` |
| List audits | GET | `/api/v1/audits` |
| Get audit | GET | `/api/v1/audits/{reference_number}` |
| Update audit metadata | PUT | `/api/v1/audits/{reference_number}` |
| PDF certificate | GET | `/api/v1/audits/{reference_number}/certificate` |
| XML evidence | GET | `/api/v1/audits/{reference_number}/certificate/xml` |
| Partner search in your audits | GET | `/api/v1/partners/check?q=...` |

## Public JSON (limited, throttled)

- GET **https://viesac.eu/vies-check?vat=...** — lightweight public check for landing/tools; not a substitute for the authenticated API.

## Tools and content

- [Free VAT tools hub](https://viesac.eu/tools)
- [EU VAT validator](https://viesac.eu/tools/eu-vat-validator)
- Articles and localized paths: `/articles`, `/{locale}/...` (supported locales in app config).

## Plugin / agent manifests

- [OpenAPI](https://viesac.eu/openapi.yaml)
- [AI plugin manifest](https://viesac.eu/.well-known/ai-plugin.json) (ChatGPT-style plugin descriptor; points at OpenAPI).

## Contact

Website: https://viesac.eu — use contact or legal pages linked in the site footer.