openapi-documents git:20260610.0dfad19A

Immutable. This exact content is served forever at /api/v1/blob/8ba97a243f39f0c2.

---
name: openapi-documents
description: Obtain official Italian documents through Openapi - chamber of commerce reports (visure camerali), financial statements/balance sheets, company files (fascicoli), bylaws, DURC, protest reports. Use when the user needs an official PDF document about an Italian company or person.
---

# Openapi official documents

Two main services deliver official documents; both are **asynchronous** (request → poll → download PDF) and **paid per document** — check wallet credit (`openapi-auth` skill) and confirm with the user before bulk requests.

## DocuEngine (preferred) — `https://docuengine.openapi.com`

Official documents from the Business Register, Revenue Agency, Municipalities and INPS, behind one uniform API:

1. `GET /documents` — list available document services (codes, prices).
2. `POST /requests` — create a request with the service code and subject (VAT/tax code); optionally pass a `callback` URL.
3. `GET /requests/{id}` — poll until the request state is fulfilled (`EVASA`).
4. `GET /requests/{id}/documents` — download the resulting documents.
5. `PATCH /requests/{id}` — update a request when the service asks for it (e.g. optical balance-sheet processing).

Document families: visura camerale (ordinaria/storica, per company type, also in English), fascicolo società (current/historical), bilancio (XBRL, ottico, riclassificato), statuto, certificato di iscrizione, certificato artigiano, DURC online, visura protesti and pregiudizievoli (companies and natural persons), cariche/quote/soci attivi, eventi negativi, atto ottico.

## Visure Camerali — `https://visurecamerali.openapi.it`

Direct chamber-of-commerce endpoints, one resource per document type, all with the same pattern `POST /<type>` → `GET /<type>/{id}` → `GET /<type>/{id}/allegati` (download):

- `ordinaria-impresa-individuale`, `storica-impresa-individuale`
- `ordinaria-societa-capitale`, `storica-societa-capitale`
- `ordinaria-societa-persone`, `storica-societa-persone`
- `bilancio-ottico`, `certificato-iscrizione`, `certificato-iscrizione-vigenza`, …
- Company search first: `GET /impresa?...` or `GET /impresa/{cf_piva_id}` to identify the subject.

Visengine (`https://visengine2.altravia.com`) is the older engine for the same families — prefer DocuEngine for new work.

## Notes

- Sandbox responses are illustrative; enable sandbox credit in the console first.
- Full specs: https://console.openapi.com/oas/en/docuengine.openapi.json · https://console.openapi.com/oas/en/visurecamerali.openapi.json · https://console.openapi.com/oas/en/visengine.openapi.json