Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Imperio Utilities — API fiscali italiane Demo pubblica API
description: 'API HTTP pubbliche di Imperio Utilities: 23 tool fiscali e di compliance italiani,
deterministici e verificati (Codice Fiscale, Partita IVA, IBAN, FatturaPA/SDI, IMU, IVA,
forfettario, F24, ATECO, INTRASTAT, NIS2, verifica anti-frode del fornitore).
**Autenticazione**: header `X-API-Key`. Una chiave gratuita si ottiene registrandosi su https://imperioutils.com/signup
e si rigenera da https://imperioutils.com/settings/profile. Il `Authorization: Bearer` è la sessione della web app, non l''integrazione.
**Senza account**: ogni tool è provabile via `POST /registry/demo/{slug}` (10 richieste al minuto per IP)
oppure via il server MCP su `POST /mcp` (JSON-RPC 2.0, 60 richieste al minuto per IP).
**Prezzi e limiti**: https://imperioutils.com/docs · **Canale agenti**: https://imperioutils.com/mcp'
version: '2.0'
contact:
name: Imperio Utilities
url: https://imperioutils.com/docs
servers:
- url: https://imperioutils.com/api
description: Produzione
tags:
- name: Demo pubblica
paths:
/registry/demo/{slug}:
post:
tags:
- Demo pubblica
operationId: runPublicDemo
summary: Esegui un tool senza account (demo pubblica K5a)
description: 'Percorso anonimo, €0, nessuna chiave. Throttle 10 richieste al minuto per indirizzo IP, input cappato, niente batch. Gli `slug`/`action` ammessi sono quelli elencati nelle operazioni `/python/…` di questo documento. È la stessa route del worker che serve la versione autenticata: stesso motore, stesso risultato.'
parameters:
- name: slug
in: path
required: true
schema:
type: string
description: Slug del tool (es. `fisco-it-validator`).
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
action:
type: string
maxLength: 40
description: Azione della whitelist. Omessa, vale l'azione di default dello slug.
input:
type: object
description: 'I campi del tool — gli stessi dell''operazione `/python/…` gemella. Vanno annidati qui: il DTO rifiuta le proprietà sconosciute alla radice.'
required:
- input
example:
action: cf
input:
codice_fiscale: RSSMRA85T10A562S
responses:
'200':
description: Il JSON dello strumento.
'404':
description: Slug o action fuori dalla whitelist.
'429':
description: Tetto anonimo per IP superato.
components:
securitySchemes:
JWT:
scheme: bearer
bearerFormat: JWT
type: http
ApiKey:
type: apiKey
in: header
name: X-API-Key
externalDocs:
description: Documentazione, prezzi e limiti
url: https://imperioutils.com/docs