# Openapi Documents

> 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.

- **Type:** Skill
- **Install:** `agentstack add skill-openapi-openapi-skills-openapi-documents`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [openapi](https://agentstack.voostack.com/s/openapi)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [openapi](https://github.com/openapi)
- **Source:** https://github.com/openapi/openapi-skills/tree/main/skills/openapi-documents
- **Website:** https://openapi.com

## Install

```sh
agentstack add skill-openapi-openapi-skills-openapi-documents
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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 /` → `GET //{id}` → `GET //{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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [openapi](https://github.com/openapi)
- **Source:** [openapi/openapi-skills](https://github.com/openapi/openapi-skills)
- **License:** MIT
- **Homepage:** https://openapi.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-openapi-openapi-skills-openapi-documents
- Seller: https://agentstack.voostack.com/s/openapi
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
