agentleFS
openapiopenapi/openapi-llm-wiki/llms-full.txt

openapi-llm-wiki

llms.txt12 starsChanged 34 days agoMITView on GitHub

All Markdown files of https://github.com/openapi/openapi-llm-wiki concatenated. Generated by scripts/build-llms.sh, do not edit by hand. Sources: https://openapi.com/ · https://openapi.com/about-us · https://console.openapi.com/support (structured data) · GitHub organization profile Openapi® (Openapi S.p.A.) is the largest certified API marketplace in Europe, based in Rome, Italy. It empowers businesses to accelerate digital transformation, simplify operations, and innovate faster through APIs. Slogan: "API Made Simple". A single platform exposing 400+ API services about companies, individuals, real estate, automotive, finance, direct marketing, digital trust, and communication, organized…

We split this llms-full.txt into the rules it gives an agent

8 rules. About 0 are common, 8 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈8

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    All data comes from official and certified sources, including:

    line 62
  2. Distinctive:

    Test environment with free requests.

    line 211
  3. Distinctive:

    Only official and certified sources — see company-profile.md for the full list (Revenue Agency, Chamber of Commerce, CRIF, INPS, Poste …

    line 281
  4. Distinctive:

    Create an BusinessRegistryConfiguration with <b>POST /business_registry_configurations</b> for your <em>fiscal_id</em> and your *email*

    line 1186
  5. Distinctive:

    Create an ApiConfiguration for your BusinessRegistryConfiguration with <b>POST /api_configurations</b>.

    line 1190
  6. Distinctive:

    Create an XML invoice on the endpoint relative to your configuration

    line 1193
  7. Distinctive:

    When creating a BusinessRegistryConfiguration, you will be asked to provide an email address which will be registed on the platform.

    line 1207
  8. Distinctive:

    Use this API to verify the validity and trustworthiness of data such as email addresses and mobile phone numbers.

    line 1281

≈ “Common” is an estimate: at least 1 in 5 of the 3,225 llms.txt files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
llms-full.txt
# Openapi LLM Wiki (full)

> All Markdown files of https://github.com/openapi/openapi-llm-wiki concatenated.
> Generated by scripts/build-llms.sh, do not edit by hand.

---
<!-- source: knowledge/company-profile.md -->

# Who is Openapi?

> Sources: https://openapi.com/ · https://openapi.com/about-us · https://console.openapi.com/support (structured data) · GitHub organization profile

Openapi® (Openapi S.p.A.) is **the largest certified API marketplace in Europe**, based in Rome, Italy. It empowers businesses to accelerate digital transformation, simplify operations, and innovate faster through APIs. Slogan: **"API Made Simple"**.

## Company facts

| Fact | Value |
|---|---|
| Legal name | Openapi SpA |
| VAT / Tax ID | IT 12485671007 |
| Founded | 2013-10-20, Rome |
| Founder | Luca Scuriatti |
| Key people | Simone Desantis (CTO), Shaun De Lucia (COO), Alessandro Mollicone (CMO) |
| Headquarters | Viale Filippo Tommaso Marinetti 221, 00154 Rome, Italy |
| Parent | Open Holding Srl |
| Memberships | Linux Foundation, Assintel, ANCIC, Organismo di Monitoraggio |
| Awards | FT1000 (Financial Times, 2023), Leader della Crescita (Il Sole 24 Ore, 2024) |

## History

- **2013** — Founded; first operational office in Rome.
- **2016** — Research & Development center opened in Terni.
- **2018** — Started third-party API development.
- **2021** — Launch of the Openapi.com marketplace.
- **2023** — Incorporated as a joint-stock company (SpA).

## What Openapi offers

A single platform exposing **400+ API services** about companies, individuals, real estate, automotive, finance, direct marketing, digital trust, and communication, organized in 10 main categories: AI, Automotive, Business Information, Digital Transformation, Communication, ID & Trust, Official Documents, Person, Real Estate, Other APIs.

Key numbers (2024): 100M+ API requests per year, 14,000+ users, 12,000+ customers (including Crédit Agricole, PwC, Deliveroo).

Key advantages:

- 400+ API services on one platform
- Certified, up-to-date data sources
- Simple integration, pay-as-you-go pricing (wallet) or subscriptions
- Secure and scalable infrastructure
- "Codeless" integrations via MCP and CRM connectors (HubSpot, Odoo, Salesforce)

Target industries: Banking & Financial, Credit Recovery, E-commerce, Insurance, Real Estate, Retail, Sales, Software & IT, Startups, Telecommunications.

## Certifications

- UNI EN ISO 9001:2015 — Quality Management
- ISO/IEC 27001:2022 — Information Security Management
- ISO 25012:2014 — Data Quality
- UNI PdR 125:2022 — Gender Equality

## Data sources

All data comes from official and certified sources, including:

- **Revenue Agency (Agenzia delle Entrate)** — real estate/land registry data, invoicing codes, company activity status
- **Chamber of Commerce Company Register** — company registration reports (visure), financial statements, XBRL
- **CRIF** — personal, economic, employee, web and exponent data of Italian companies
- **INPS** — quarterly employee headcount data
- **Poste Italiane** — registered mail, telegrams, court documents (single or bulk)
- **Ministry of Transport** (European basis) — vehicle information and services
- **European Certification Authorities and Identity Providers** — digital signature, SPID, time stamping, certified e-mail (PEC/REM)
- **National Research Council (CNR)** — certified registrar for website/domain information
- **IndicePA** — index of Italian public administrations
- **Protest Register and other registers** — negative events and score calculation
- Tax Assistance Centres (CAF), company social accounts and websites, proprietary forecasting systems
---
<!-- source: knowledge/services-catalog.md -->

# Openapi services catalog

The console API Library lists 28 APIs. Each entry below links the OAS snapshot in [`oas/`](oas/) and the generated endpoint reference in [`services/`](services/). Newer services live on `*.openapi.com`, legacy ones on `*.openapi.it`, `ws.*` or `*.altravia.com` hosts.

## Platform / authentication

| API | Base URL | Reference | Notes |
|---|---|---|---|
| OAuth v2 | `https://oauth.openapi.com` | [services/oauthv2.md](services/oauthv2.md) | Token creation/management, scopes, wallet, stats, subscriptions. **Use this.** |
| OAuth (v1) | `https://oauth.openapi.it` | [services/oauth.md](services/oauth.md) | **Deprecated** — replaced by OAuth v2. |

## Business information

| API | Base URL | Reference | Notes |
|---|---|---|---|
| Company | `https://company.openapi.com` | [services/company.md](services/company.md) | Company data worldwide: IT (start/advanced/full), EU countries, FR, worldwide search, credit score. |
| Imprese | `https://imprese.openapi.it` | [services/imprese.md](services/imprese.md) | Legacy Italian company lookup by VAT/denomination. |
| Risk | `https://risk.openapi.com` | [services/risk.md](services/risk.md) | CRIF reports, credit score, KYC, negative events on persons and companies. |
| Trust | `https://trust.openapi.com` | [services/trust.md](services/trust.md) | Verification of emails, mobile numbers, IPs, URLs, PEC, fiscal codes, license plates. |

## Official documents

| API | Base URL | Reference | Notes |
|---|---|---|---|
| DocuEngine | `https://docuengine.openapi.com` | [services/docuengine.md](services/docuengine.md) | Official documents from Business Register, Revenue Agency, Municipalities, INPS. |
| Visure Camerali (Chamber of Commerce Company Registrations) | `https://visurecamerali.openapi.it` | [services/visurecamerali.md](services/visurecamerali.md) | Company registration reports (visure), financial statements. |
| Visengine | `https://visengine2.altravia.com` | [services/visengine.md](services/visengine.md) | Documents from Chamber of Commerce, INPS, Tax Agency (older engine). |

## Real estate & geo

| API | Base URL | Reference | Notes |
|---|---|---|---|
| Italian Cadastre (Catasto) | `https://catasto.openapi.it` | [services/catasto.md](services/catasto.md) | Cadastral data and property owners in Italy. |
| Real Estate | `https://realestate.openapi.com` | [services/realestate.md](services/realestate.md) | Comparable properties and valuations. |
| Geocoding | `https://geocoding.openapi.it` | [services/geocoding.md](services/geocoding.md) | Forward and reverse geocoding. |
| Zip Codes (CAP) | `https://cap.openapi.it` | [services/cap.md](services/cap.md) | Italian zip codes, municipalities, provinces, regions, ISTAT codes. |

## Communication

| API | Base URL | Reference | Notes |
|---|---|---|---|
| SMS v2 | `https://sms.openapi.com` | [services/smsv2.md](services/smsv2.md) | SMS with custom sender, delivery reports (IT, ES, worldwide). |
| SMS v1 (Gateway SMS) | `https://ws.messaggisms.com` | [services/gatewaysms.md](services/gatewaysms.md) | **Deprecated** — replaced by SMS v2. |
| Italian certified e-mail (PEC) | `https://pec.openapi.it` | [services/pec.md](services/pec.md) | Activate and manage Legalmail certified e-mail. |
| Massive REM (PEC Massiva) | `https://ws.pecmassiva.com` | [services/pecmassiva.md](services/pecmassiva.md) | Bulk certified e-mail sending with delivery/receipt verification. |
| Postal Service (Ufficio Postale) | `https://ws.ufficiopostale.com` | [services/ufficiopostale.md](services/ufficiopostale.md) | Registered mail, telegrams, priority mail via Poste Italiane. |

## Digital trust & signatures

| API | Base URL | Reference | Notes |
|---|---|---|---|
| eSignature | `https://esignature.openapi.com` | [services/esignature.md](services/esignature.md) | eIDAS-compliant digital signatures. |
| Digital Signature (Firma Digitale) | `https://ws.firmadigitale.com` | [services/firmadigitale.md](services/firmadigitale.md) | **Deprecated** — replaced by eSignature. Infocert/Aruba kits, digital identities. |
| Time Stamping (Marche Temporali) | `https://ws.marchetemporali.com` | [services/marchetemporali.md](services/marchetemporali.md) | Purchase and apply qualified timestamps. |

## Invoicing & payments

| API | Base URL | Reference | Notes |
|---|---|---|---|
| Invoice | `https://invoice.openapi.com` | [services/invoice.md](services/invoice.md) | Italian electronic invoices and digital receipts, SDI transmission, legal storage. |
| SDI | `https://sdi.openapi.it` | [services/sdi.md](services/sdi.md) | Direct interaction with the Sistema di Interscambio (send/receive invoices). |
| Paying Bills (Bollettini) | `https://ws.pagasubito.it` | [services/bollettini.md](services/bollettini.md) | Pay bills, MAV, RAV, PagoPA, car tax. |

## Other

| API | Base URL | Reference | Notes |
|---|---|---|---|
| AI (RAG) | `https://ai.openapi.com` | [services/ai.md](services/ai.md) | Managed Retrieval-Augmented Generation: create RAGs, index documents, query. |
| Automotive | `https://automotive.openapi.com` | [services/automotive.md](services/automotive.md) | Vehicle data by license plate (cars, motorcycles, insurance). |
| Exchange Rate | `https://exchange.altravia.com` | [services/exchange.md](services/exchange.md) | Real-time currency exchange rates. |
| .it Domains | `https://domains.altravia.com` | [services/domains.md](services/domains.md) | Register and manage .it domains. |
| PDF | `https://pdf.openapi.it` | [services/pdf.md](services/pdf.md) | HTML/URL to PDF (renders JavaScript). |

## Deprecation summary

| Deprecated API | Replacement |
|---|---|
| OAuth v1 (`oauth.openapi.it`) | OAuth v2 (`oauth.openapi.com`) |
| SMS v1 / Gateway SMS (`ws.messaggisms.com`) | SMS v2 (`sms.openapi.com`) |
| Digital Signature (`ws.firmadigitale.com`) | eSignature (`esignature.openapi.com`) |
---
<!-- source: knowledge/platform-guide.md -->

# Platform guide: authentication, scopes, billing, sandbox

How the Openapi platform works across all services. Distilled from the OAuth v2 spec ([oas/oauthv2.openapi.json](oas/oauthv2.openapi.json)) and the console FAQ ([faq.md](faq.md)).

## Authentication model

Two layers:

1. **API key (Basic auth)** — your account credentials: username = account email, password = API key. Used **only** against `oauth.openapi.com` to create and manage tokens.
2. **Bearer token** — created via OAuth v2 with a set of scopes; sent as `Authorization: Bearer <token>` to every service API (`company.openapi.com`, `risk.openapi.com`, …).

### Creating a token

```
POST https://oauth.openapi.com/tokens
Authorization: Basic base64(email:apikey)
Content-Type: application/json

{
  "scopes": ["GET:company.openapi.com/IT-start", "POST:sms.openapi.com/messages"],
  "name": "My integration token",
  "ttl": 2592000,              // seconds, max 1 year
  "limits": { ... }            // optional usage limits
}
```

- **Scope format**: `METHOD:host/path-prefix`, e.g. `GET:company.openapi.com/IT-full`. List all available scopes with `GET /scopes`.
- Tokens can also be created from the console UI: Authentication → "+New Token".
- A **refresh token** can be used as Bearer on `PATCH /tokens/{id}` to renew a token without the access token.

### Other OAuth v2 endpoints

- `GET /tokens`, `GET/PATCH/DELETE /tokens/{token}` — token lifecycle
- `GET /scopes`, `GET /scopes/{id}` — available scopes
- `GET /wallet`, `GET /wallet/transactions` — credit balance and history
- `GET /subscriptions`, `GET /subscriptions/{id}` — active plans
- `GET /stats`, `GET /stats/apis`, `GET /stats/apis/{domain}`, `GET /stats/ips` — usage analytics
- `GET /errors`, `GET /callbacks` — error logs and callback monitoring

OAuth v1 (`oauth.openapi.it`) is deprecated; use OAuth v2.

## Billing

- **Pay per request (wallet/"purse")**: each call is charged against your credit. Top up via console (PayPal, credit card, bank transfer); Auto-Recharge available with credit card.
- **Subscriptions**: monthly (30 days, no rollover) or annual (365 days, requests usable at any pace net of instalment limits) per API; cheaper per request.
- Both models can coexist — payment mode is chosen per API; keep wallet credit as fallback when subscription requests run out.
- Some APIs include **free tiers** (daily/monthly free requests) — see the Price section of each API.

## Sandbox

- Test environment with free requests; requires enabling "sandbox credit" in the console first.
- Responses are illustrative and may be incomplete; some APIs publish test VAT numbers/plates (e.g. https://docs.openapi.it/imprese-sandbox-examples.html).

## Async request pattern

Many document/report services (DocuEngine, Visure Camerali, Visengine, Risk, Company advanced) are **asynchronous**:

1. `POST` the request → returns a request `id` and state (e.g. `RICHIESTA`/`EVASA`).
2. Optionally pass a `callback` URL to be notified on completion.
3. Poll the status endpoint with the `id` until the document/report is ready.
4. Download the result (often a PDF, sometimes base64 or a document URL).

## Compliance notes

- Some services (typically risk/investigative data) are subject to the Italian **TULPS** regulation (Art. 6 license) and require uploading an identity document of the legal representative or a delegate before activation.
- Rate limits, when present, are stated in each API's description.
- System status: https://openapi-com.statuspage.io
---
<!-- source: knowledge/faq.md -->

# Openapi Console FAQ

> Source: https://console.openapi.com/support (extracted 2026-06-10)

## Account

**How can I sign up on Openapi?**
You can sign up via: (1) Google account, (2) GitHub account, (3) email address. With email you receive instructions within a few seconds to complete the registration.

**I did not receive the email after registering, what should I do?**
The email is only sent when email was chosen as registration method. Check the Promotions/Updates tab (Gmail) and the spam folder; otherwise contact the [Support Form](https://openapi.it/en/support).

**Can I change my password?**
Yes, if you registered by email: in your personal area, section Preferences.

**I have forgotten my password, what can I do?**
- Email registration: click "I forgot my password" in the login area.
- Google account: follow Google's account-recovery procedure.
- GitHub account: use GitHub's "Forgot password?".

**Is it possible to add an additional user to my Openapi account?**
No — one email per account. An additional email can be added for notifications only.

**Can I delete my Openapi account?**
Yes, in Preferences → "Delete your account". WARNING: data is permanently deleted and tokens are invalidated; this cannot be undone.

## API usage

**What are the differences between individual and subscription requests?**
Requests are paid from the wallet ("purse", per request) or via subscription. Subscriptions have a monthly/yearly request limit but a lower cost per request; single requests are unlimited as long as you have credit.

**Is it possible to access free requests?**
Yes, some APIs include daily and/or monthly free requests, shown in the API's Price section.

**How does the Sandbox area work?**
The sandbox is for testing before production. Test requests are free, but you must set up "sandbox credit" first. Sandbox responses are illustrative and may be incomplete; some APIs provide test VAT numbers.

**How do I create the token?**
Two ways: via the OAuth API (POST to the token endpoint) or via the "New Token" tool in the console's Authentication section.

**Where can I view my tokens?**
In your private area under Authentication, where you can also create new tokens (+New Token).

**Can I check my consumption?**
Yes — per single call, per subscription, and per API in the dedicated tab.

**How can I check rate limits on endpoints?**
Any limits are indicated in the descriptions of the individual APIs.

**From which sources does the data provided by Openapi come?**
Only official and certified sources — see [company-profile.md](company-profile.md#data-sources) for the full list (Revenue Agency, Chamber of Commerce, CRIF, INPS, Poste Italiane, Ministry of Transport, CNR, IndicePA, Protest Register, certification authorities, CAF, company websites/socials, proprietary processing).

**Why is the identity document submission procedure necessary to activate certain APIs?**
Some services fall under the Italian TULPS regulation (Article 6 license), which requires identification of the requesting individual or company.

**Which document should I upload for identity verification?**
A driver's license, passport, or identity card of the legal representative, of a person with signing powers, or of a delegate (e.g., IT manager or administrative office).

**Can I contact you for assistance?**
Yes, via the [Support Form](https://openapi.it/en/support).

## Payments and subscriptions

**I would like to top up my credit, how do I do this?**
Personal area → Transactions → "Recharge your wallet". You can also enable Auto Recharge (automatic top-up below a threshold; credit card only).

**What are the payment methods?**
PayPal, credit card, bank transfer. Credit card requires recurring payment for monthly/annual subscriptions (deactivatable anytime). Auto-recharge is available for credit card only.

**How does Auto-Recharge work?**
Set a minimum threshold and a top-up amount at purchase time; the top-up triggers only when credit falls below the threshold. Deactivatable anytime; credit card only.

**I would like to activate a subscription, how can I do?**
Select the desired plan in the dedicated section at the API level.

**How do monthly and annual subscriptions work?**
Monthly: 30 days, unused requests do not roll over. Annual: 365 days; requests (net of API-specific instalment limits) can be used at any pace over the year.

**Annual vs monthly-paid-12-months-in-advance?**
Annual has no monthly consumption limits (net of API instalment limits). Monthly prepaid for 12 months keeps the monthly call limits but costs less than the regular monthly plan.

**Can I check the status of my subscription(s)?**
Yes, in My Subscriptions (status and usage report), and per API in its dedicated section.

**Can 'Subscription payment' and 'Payment per request' co-exist?**
Yes — payment method is per API. Tip: keep some wallet credit so that when subscription requests run out the API keeps working with single requests.

**I have run out of requests in my subscription. What can I do?**
Renew immediately, switch to another plan, or fall back to single requests paid from the wallet (top up if needed).
---
<!-- source: knowledge/references.md -->

# References

External resources to use when building and maintaining the skills.

## Official websites

| Resource | URL |
|---|---|
| Marketplace / corporate site | https://openapi.com/ |
| About us | https://openapi.com/about-us |
| Developer console (account, tokens, sandbox, playground) | https://console.openapi.com/ |
| API Library | https://console.openapi.com/apis |
| Support & FAQ | https://console.openapi.com/support |
| Documentation portal | https://docs.openapi.com/ (legacy: https://docs.openapi.it/) |
| Blog (tutorials, announcements) | https://openapi.com/blog |
| System status | https://openapi-com.statuspage.io |

## GitHub repositories (github.com/openapi)

| Repo | Purpose |
|---|---|
| https://github.com/openapi/openapi-rust-sdk | Official Rust SDK |
| https://github.com/openapi/openapi-php-sdk | Official PHP SDK |
| https://github.com/openapi/openapi-python-sdk | Official Python SDK |
| https://github.com/openapi/mcp-server | Official MCP server (Model Context Protocol gateway to Openapi services) |
| https://github.com/openapi/openapi-cli | Official CLI; its `oas/` folder holds the OpenAPI 3 specs mirrored in [`knowledge/oas/`](oas/) |

Legacy organization: https://github.com/openapi-it

## OpenAPI specification sources

Canonical, always-current spec URLs (English): `https://console.openapi.com/oas/en/<service>.openapi.json` — the full list is in [`oas/00-list.txt`](oas/00-list.txt). A snapshot of all 29 specs is vendored in [`knowledge/oas/`](oas/), and per-service endpoint summaries generated from them live in [`knowledge/services/`](services/).

## Other channels

- Postman: https://www.postman.com/openapi-com/workspace/openapi-com-public-workspace/overview
- YouTube: https://www.youtube.com/@openapi-com
- LinkedIn: https://www.linkedin.com/company/openapi-com
- Facebook: https://www.facebook.com/openapicom · Instagram: https://www.instagram.com/openapi_com
---
<!-- source: knowledge/services/ai.md -->

# RAG Management API

- **Base URL**: `https://ai.openapi.com`
- **OAS file**: [`knowledge/oas/ai.openapi.json`](../oas/ai.openapi.json)
- **Version**: 1.4.0

## Description

This documentation provides a comprehensive description of the API for managing Retrieval-Augmented Generation (RAG) systems. Through the APIs, it is possible to create a RAG, retrieve its details, initiate file indexing, and delete it. It is also possible to view all of a user's RAGs. Furthermore, the APIs allow for document management, enabling the upload of both text documents and images. Additionally, metadata can be specified for each document to filter search queries. The service's three main endpoints are dedicated to querying the RAG. These endpoints allow users to submit queries and receive responses that combine the power of generative models (LLMs) with specific knowledge extracted from the indexed documents.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/rag` | Retrieve a list of RAG |
| POST | `/rag` | Create a new RAG |
| GET | `/rag/{id}` | Get RAG details |
| PATCH | `/rag/{id}` | Start RAG indexing |
| DELETE | `/rag/{id}` | Delete a RAG |
| GET | `/rag/{id}/documents` | List documents in a RAG |
| POST | `/rag/{id}/documents` | Upload a document |
| DELETE | `/rag/{id}/documents/{fileId}` | Delete a single document |
| POST | `/rag-search` | Perform a simple search |
| POST | `/rag-search-with-answer` | Perform a search with a generated answer |
| POST | `/rag-conversation` | Perform a conversational search |

---
<!-- source: knowledge/services/automotive.md -->

# Automotive

- **Base URL**: `https://automotive.openapi.com`
- **OAS file**: [`knowledge/oas/automotive.openapi.json`](../oas/automotive.openapi.json)
- **Version**: 1.0.0

## Description

The API provides a vehicle information consulting service based on license plate numbers, with three distinct endpoints for cars, motorcycles, and insurance checks. Developed from the "automotive" endpoint, the service delivers accurate and reliable details about vehicles.


**IN SANDBOX**

The Sandbox service provides a testing environment for the Automotive API, allowing users to simulate requests and receive sample data for evaluation purposes. In this environment, users can test the service's functionality by submitting queries using either the License Plate (for most endpoints) or the KBANumber (for the German endpoint). The key distinction is that, instead of retrieving real-world data, the Sandbox service returns predefined, dummy data designed for testing scenarios. This enables users to assess their integration with the API, validate their implementation, and familiarize themselves with the expected responses before moving to a production environment.


## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/check_id/{id}` | Check request |
| GET | `/IT-car/{LicensePlate}` | Information about a car |
| GET | `/IT-bike/{LicensePlate}` | Information about a motorcycle |
| GET | `/IT-insurance/{LicensePlate}` | Information about car insurance |
| GET | `/UK-car/{LicensePlate}` | Information about a car |
| GET | `/UK-bike/{LicensePlate}` | Information about a motorcycle |
| GET | `/UK-mot/{LicensePlate}` | Information about car mot |
| GET | `/DE-car/{KBANumber}` | Information about a car |
| GET | `/FR-car/{LicensePlate}` | Information about a car |
| GET | `/FR-bike/{LicensePlate}` | Information about a motorcycle |
| GET | `/PT-car/{LicensePlate}` | Information about a car |
| GET | `/PT-insurance/{LicensePlate}` | Information about car insurance |
| GET | `/ES-car/{LicensePlate}` | Information about a car |
| GET | `/ES-bike/{LicensePlate}` | Information about a motorcycle |

---
<!-- source: knowledge/services/bollettini.md -->

# Bollettini

- **Base URL**: `https://ws.pagasubito.it`
- **OAS file**: [`knowledge/oas/bollettini.openapi.json`](../oas/bollettini.openapi.json)
- **Version**: 1.0.0

## Description

Web service that allows you to pay bills, mav, rav, pago pa and car tax.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| POST | `/pay/{endpoint}` | Bill payment request |
| GET | `/pay/` | All request |
| GET | `/pay/{id}` | Single request |
| GET | `/pay/{id}/ricevuta` | Get the receipt |

---
<!-- source: knowledge/services/cap.md -->

# Cap

- **Base URL**: `https://cap.openapi.it`
- **OAS file**: [`knowledge/oas/cap.openapi.json`](../oas/cap.openapi.json)
- **Version**: 1.0.0

## Description

This service allows you to search italian cities and get their istat and cap codes. <br> <br> <h2>Testing</h2>Please note that the sandbox environment is loaded with a limited dataset and is intended to be used for testing purposes. Some search parameters might not work or return always the same data.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/cerca_comuni` | Search cities by name, region and/or province |
| GET | `/comuni_base/{istat_code}` | Get basic information about a city |
| GET | `/comuni_advance/{istat_code}` | Get more information about a city |
| GET | `/cap/{cap}` | Get a list of cities that match a cap |
| GET | `/regioni` | Get the list of italian regions |
| GET | `/province` | Get the list of italian provinces |
| GET | `/province/{code}` | Get an italian province |
| GET | `/comuni_soppressi` | Get a list of suppressed municipalities |
| GET | `/citta_metropolitane` | Get a list of Italian metropolitan cities |

---
<!-- source: knowledge/services/catasto.md -->

# Catasto

- **Base URL**: `https://catasto.openapi.it`
- **OAS file**: [`knowledge/oas/catasto.openapi.json`](../oas/catasto.openapi.json)
- **Version**: 3.0.0

## Description

This API provides structured access to official Italian real estate registry information related to **properties** and **subjects** (individuals and legal entities).

### **Dati Catastali**
The API allows consultation of the Italian Cadastre to retrieve detailed information about buildings and land plots and their registered holders. It is possible to:
- consult cadastral data for a specific property
- identify the registered holders of a property
- retrieve the list of properties owned by a physical or legal subject
- obtain detailed descriptions of properties associated with a subject
- determine the total number of land plots and buildings owned by a subject
- retrieve the list of properties located on a specific address\n
### **Visure Catastali**
The API includes the generation of the cadastral view PDF (Visura Catastale) for both properties and subjects.
### **Visure Ipotecarie**
The API includes access to **land registry searches (visure ipotecarie)**, which provide information about **registry entries (notes/formalities)** associated with properties or subjects, as recorded by the Italian Land Registry Offices (Conservatorie).
Through land registry search services it is possible to:
- identify the Land Registry Offices where a subject has
  regist entries (notes/formalities)
- retrieve the list of registry entries for a subject or property
  within a specific Land Registry Office
- obtain the detailed information of a single registry entry
### **Estratto Mappa**
Through this service you can get the pdf of the map extract from the land registry


## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/territorio` | List provinces |
| GET | `/territorio/{provincia_or_nome_provincia_or_id}` | Province detail |
| GET | `/territorio/{provincia_or_nome_provincia_or_id}/{comune}` | Municipality detail |
| GET | `/territorio/conservatorie` | List of Land Registry Offices |
| GET | `/territorio/conservatorie/{conservatoria_or_id}` | Land Registry Office municipalities and cadastral sections |
| POST | `/richiesta/{endpoint}/` | Creates a request |
| GET | `/richiesta` | Extracts all requests |
| GET | `/richiesta/{id}` | Detail of the request |
| POST | `/indirizzo` | Create address search request |
| GET | `/indirizzo` | Search for an address |
| GET | `/indirizzo/{id}` | Detail of the address |
| POST | `/visura_catastale` | Create visura request |
| GET | `/visura_catastale` | Extracts all visure |
| GET | `/visura_catastale/{id}` | Detail of the visura |
| GET | `/visura_catastale/{id}/documento` | Download visura |
| POST | `/ipotecarie-ispezione_nazionale` | National land registry inspection request |
| POST | `/ipotecarie-elenco-note` | Land registry notes list request |
| POST | `/ipotecarie-dettaglio-nota` | Land registry note detail request |
| GET | `/ipotecarie` | Extracts all mortgage inspections |
| GET | `/ipotecarie/{id}` | Detail of a mortgage inspection request |
| GET | `/ipotecarie/{id}/documento` | Download visura |
| POST | `/estratto_mappa` | Create a map extract request |
| GET | `/estratto_mappa` | Extracts all requests |
| GET | `/estratto_mappa/{id}` | Detail of the extract map |
| GET | `/estratto_mappa/{id}/documento` | Download map |

---
<!-- source: knowledge/services/company.md -->

# Company

- **Base URL**: `https://company.openapi.com`
- **OAS file**: [`knowledge/oas/company.openapi.json`](../oas/company.openapi.json)
- **Version**: 1.0.0

## Description

This service provides REST calls to extract information on businesses and companies from VAT or TAX code (or other identifiers especially for non-European countries).

Beyond Italy, there are endpoints targeting individual European countries like France, Germany, Spain, or the United Kingdom (and many others), or three endpoints that encompass a search for every country in the world.

In addition to synchronous information, there is also the ability to intercept any changes that occur within a company through the new monitoring section.

At this <a href='https://docs.openapi.it/company-sandbox-examples.html' target='_blank'>link</a> you can find a list of companies that allow you to try the service in a sandbox environment.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/IT-aml/{vatCode_or_taxCode}` | Anti Money Laundering |
| POST | `/IT-aml/{vatCode_or_taxCode}` | Aml |
| GET | `/IT-marketing/{vatCode_or_taxCode}` | Marketing |
| POST | `/IT-marketing/{vatCode_or_taxCode}` | Marketing |
| GET | `/IT-stakeholders/{vatCode_or_taxCode}` | Stakeholders |
| POST | `/IT-stakeholders/{vatCode_or_taxCode}` | Stakeholders |
| GET | `/IT-full/{vatCode_or_taxCode}` | All the data |
| POST | `/IT-full/{vatCode_or_taxCode}` | Full |
| GET | `/IT-check_id/{id}` | Check request |
| GET | `/IT-start/{vatCode_taxCode_or_id}` | Basic data |
| GET | `/IT-advanced/{vatCode_taxCode_or_id}` | Advanced data |
| GET | `/IT-search` | Advanced search and data |
| GET | `/IT-shareholders/{vatCode_taxCode_or_id}` | Shareholders of a company |
| GET | `/IT-address/{vatCode_taxCode_or_id}` | Company address |
| GET | `/IT-pec/{vatCode_taxCode_or_id}` | Certified e-mail |
| GET | `/IT-closed/{vatCode_taxCode_or_id}` | Cessation of activity |
| GET | `/IT-vatgroup/{vatCode_or_id}` | Membership of a VAT group |
| GET | `/IT-sdicode/{vatCode_taxCode_or_id}` | SDI code of a company |
| GET | `/IT-legalforms` | All legal forms |
| GET | `/IT-legalforms/{code}` | Specific legal form |
| GET | `/EU-start/{vatCode_taxCode}` | Basic data |
| GET | `/IT-splitpayment/{taxCode_vatCode}` | A specific split-payment company |
| GET | `/IT-pa/{taxCode_vatCode}` | A specific public administration company |
| GET | `/IT-name/{vatCode_taxCode_or_id}` | Basic data |
| GET | `/IT-ubo/{vatCode_taxCode_or_id}` | Company's Ubo |
| GET | `/FR-start/{siretCode_sirenCode_vatCode_or_id}` | Basic data |
| GET | `/FR-advanced/{siretCode_sirenCode_vatCode_or_id}` | Advanced data |
| GET | `/FR-search` | Advanced search and data |
| GET | `/DE-start/{vatCode_companyNumber_or_id}` | Basic data |
| GET | `/DE-advanced/{vatCode_companyNumber_or_id}` | Advanced data |
| GET | `/ES-start/{vatCode_taxCode_or_id}` | Basic data |
| GET | `/ES-advanced/{vatCode_taxCode_or_id}` | Advanced data |
| GET | `/PT-start/{vatCode_taxCode_or_id}` | Basic data |
| GET | `/PT-advanced/{vatCode_taxCode_or_id}` | Advanced data |
| GET | `/GB-start/{vatCode_companyNumber_or_id}` | Basic data |
| GET | `/GB-advanced/{vatCode_companyNumber_or_id}` | Advanced data |
| GET | `/WW-start/{country}/{vatCode_companyNumber_taxCode_or_id}` | Basic data |
| GET | `/WW-advanced/{country}/{vatCode_companyNumber_taxCode_or_id}` | Advanced data |
| GET | `/WW-top/{country}/{vatCode_companyNumber_taxCode_or_id}` | Top data |
| GET | `/BE-start/{vatCode_companyNumber_taxCode_or_id}` | Basic data |
| GET | `/BE-advanced/{vatCode_companyNumber_taxCode_or_id}` | Advanced data |
| GET | `/AT-start/{vatCode_companyNumber_or_id}` | Basic data |
| GET | `/AT-advanced/{vatCode_companyNumber_or_id}` | Advanced data |
| GET | `/CH-start/{vatCode_companyNumber_taxCode_or_id}` | Basic data |
| GET | `/CH-advanced/{vatCode_companyNumber_taxCode_or_id}` | Advanced data |
| GET | `/PL-start/{vatCode_companyNumber_taxCode_regonNumber_or_id}` | Basic data |
| GET | `/PL-advanced/{vatCode_companyNumber_taxCode_regonNumber_or_id}` | Advanced data |
| GET | `/monitor` | List of all requests |
| POST | `/monitor` | New monitor request |
| GET | `/monitor/{id}` | Get specific request |
| DELETE | `/monitor/{id}` | Delete request monitor |

---
<!-- source: knowledge/services/docuengine.md -->

# DocuEngine

- **Base URL**: `https://docuengine.openapi.com`
- **OAS file**: [`knowledge/oas/docuengine.openapi.json`](../oas/docuengine.openapi.json)
- **Version**: 1.0.0

## Description

This service offers rest calls to obtain a series of chamber of commerce, land registry or patronage documents.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/documents` | List of all services |
| GET | `/requests` | List of all requests |
| POST | `/requests` | New request |
| GET | `/requests/{id}` | Get specific request |
| PATCH | `/requests/{id}` | Updates the request |
| GET | `/requests/{id}/documents` | Get the documents |

---
<!-- source: knowledge/services/domains.md -->

# Domains

- **Base URL**: `https://domains.altravia.com`
- **OAS file**: [`knowledge/oas/domains.openapi.json`](../oas/domains.openapi.json)
- **Version**: 1.0.0

## Description

This web service allows you to purchase and manage .it domains.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/contact` | List of your contacts |
| POST | `/contact` | Create new contact |
| GET | `/contact/{handle}` | Single contact |
| PUT | `/contact/{handle}` | Update a contact |
| DELETE | `/contact/{handle}` | Delete a contact |
| GET | `/check/{domain}` | Check domain |
| GET | `/domain` | List of your domains |
| POST | `/domain` | Register a new domain |
| GET | `/domain/{domain}` | Single domain |
| PUT | `/domain/{domain}` | Update a domain |
| DELETE | `/domain/{domain}` | Delete a domain |
| GET | `/domain/{domain}/registrant` | Get the registrant |
| GET | `/domain/{domain}/admin` | Get the admin |
| GET | `/domain/{domain}/tech` | Get the tech |
| DELETE | `/domain/{domain}/tech/{handle}` | Delete the tech |

---
<!-- source: knowledge/services/esignature.md -->

# E-Signature

- **Base URL**: `https://esignature.openapi.com`
- **OAS file**: [`knowledge/oas/esignature.openapi.json`](../oas/esignature.openapi.json)
- **Version**: 1.0.17

## Description

This API is a robust tool designed for developers and businesses looking to automate and integrate secure document signing processes into their applications. This API is fully compliant with eIDAS regulations, ensuring that all signatures meet strict European standards for legal validity.
 The documentation outlines a comprehensive suite of features, allowing users to implement various types of digital signatures, including Simple Electronic Signatures (SES) secured via OTP, Qualified Electronic Seals, and Massive Automatic Qualified Electronic Signatures (QES) for high-volume needs. Key functionalities include the ability to timestamp documents, manage certificates, and access detailed audit logs to track the entire signing lifecycle.
 The Swagger UI provided in the documentation enables developers to explore and test endpoints directly, managing signature flows, and verifying certification status facilitating a smooth integration process for dematerializing paper-based workflows.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/certificates` | Get a list of certificates |
| GET | `/certificates/{id}` | Get a certificate |
| POST | `/certificates/namirial-automatic` | Purchase a Namirial Automatic Certificate |
| POST | `/certificates/namirial-otp` | Purchase a Namirial OTP Certificate |
| GET | `/signatures` | Get a list of signatures |
| GET | `/signatures/{id}/{actionType}` | Download the signed Document, get the details, audit Trail or the validatedDocument of a signature |
| POST | `/EU-QES_automatic` | Create QES Signature using Massive Automatic Certificate |
| POST | `/EU-QES_otp` | Create QES Signature using Remote OTP Certificate |
| POST | `/EU-QES_eseal` | Create QES Signature using Remote E-seal Certificate |
| POST | `/EU-SES` | Create a SES request for one or more signers. |
| POST | `/verify` | Verify a signature |
| DELETE | `/signatures/{id}` | Delete the signed Document, the details, audit Trail and the validatedDocument of a signature |

---
<!-- source: knowledge/services/exchange.md -->

# Exchange

- **Base URL**: `https://exchange.altravia.com`
- **OAS file**: [`knowledge/oas/exchange.openapi.json`](../oas/exchange.openapi.json)
- **Version**: 1.0.0

## Description

This web service allows obtaining realtime exchange rates

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `` | This method allows you to obtain world exchange rate based on USD value |

---
<!-- source: knowledge/services/firmadigitale.md -->

# Firma Digitale

- **Base URL**: `https://ws.firmadigitale.com`
- **OAS file**: [`knowledge/oas/firmadigitale.openapi.json`](../oas/firmadigitale.openapi.json)
- **Version**: 1.0.0

## Description

Web service that allows you to purchase or renew Infocert or Aruba digital signatures, and to obtain digital identities.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/prodotti` | List of products |
| GET | `/richiesta` | List of your requests |
| GET | `/richiesta/{id}` | Specific request |
| PATCH | `/richiesta/{id}` | Update request |
| POST | `/richiesta/{codice_prodotto}` | Purchase and renew digital signatures |
| GET | `/richiesta/{id}/modulo` | Download the recognition form |
| POST | `/firma_elettronica/base` | [DEPRECATED] Request an e-signature |
| GET | `/firma_elettronica` | List all your past and pending requests |
| GET | `/firma_elettronica/{id}` | Get information on a sign request |
| GET | `/firma_elettronica/{id}/download` | Download your signed document |
| GET | `/firma_elettronica/{id}/audit` | Retrieve Audit Trail for Signed Document |
| POST | `/firma_elettronica_ui` | [DEPRECATED] Create a custom UI for e-signatures |
| GET | `/firma_elettronica_ui` | [DEPRECATED] List all your custom UIs |
| GET | `/firma_elettronica_ui/{id}` | [DEPRECATED] Get custom UI for e-signatures |
| DELETE | `/firma_elettronica_ui/{id}` | [DEPRECATED] Delete custom UI for e-signatures |
| GET | `/spid_personale` | Personal spid |

---
<!-- source: knowledge/services/gatewaysms.md -->

# Gateway SMS

- **Base URL**: `https://ws.messaggisms.com`
- **OAS file**: [`knowledge/oas/gatewaysms.openapi.json`](../oas/gatewaysms.openapi.json)
- **Version**: 1.0.0

## Description

This web service exposes REST calls to send text messages directly from our gateway

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/messages/` | List of your messages |
| POST | `/messages/` | Send a sms message |
| GET | `/messages/{id}` | Get a single message |
| PUT | `/messages/{id}` | Message integration |
| DELETE | `/messages/{id}` | Delete a single message |
| GET | `/messages/{id}/recipients/` | Get the recipients from a message |
| GET | `/messages/{id}/recipients/{number}` | Get the recipient from a message |

---
<!-- source: knowledge/services/geocoding.md -->

# Geocoding Api

- **Base URL**: `https://geocoding.openapi.it`
- **OAS file**: [`knowledge/oas/geocoding.openapi.json`](../oas/geocoding.openapi.json)
- **Version**: 1.0.0

## Description

Geocoding Api Documentation

## Endpoints

| Method | Path | Summary |
|---|---|---|
| POST | `/geocode` | Retrieve informations about a place supplying address |
| POST | `/reverse` | Get place information from ID or latitude/longitude |

---
<!-- source: knowledge/services/imprese.md -->

# Imprese

- **Base URL**: `https://imprese.openapi.it`
- **OAS file**: [`knowledge/oas/imprese.openapi.json`](../oas/imprese.openapi.json)
- **Version**: 1.0.0

## Description

This service provides REST calls to extract information on businesses and companies from simple parameters such as denomination or VAT number.

At this <a href='https://docs.openapi.it/imprese-sandbox-examples.html' target='_blank'>link</a> you can find a list of companies that allow you to try the service in a sandbox environment.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/base/{piva_cf_or_id}` | Basic data |
| GET | `/advance` | Advanced search and data |
| GET | `/advance/{piva_cf_or_id}` | Advanced search and data |
| GET | `/closed/{piva_cf_or_id}` | Cessation of activity |
| GET | `/gruppoiva/{piva_or_cf}` | Membership of a VAT group |
| GET | `/pec/{piva_cf_or_id}` | Certified e-mail |
| GET | `/autocomplete/{query}` | Search by name |
| GET | `/forma_giuridica` | All legal forms |
| GET | `/forma_giuridica/{codice_natura_giuridica}` | Specific legal form |
| GET | `/updates` | A list of updated companies |
| GET | `/updates/{timestamp}` | A list of updated companies |
| GET | `/soci/{piva_cf_or_id}` | Shareholders of a company |
| GET | `/codice_destinatario/{piva_cf_or_id}` | SDI code of a company |

---
<!-- source: knowledge/services/invoice.md -->

# Invoice

- **Base URL**: `https://invoice.openapi.com`
- **OAS file**: [`knowledge/oas/invoice.openapi.json`](../oas/invoice.openapi.json)
- **Version**: 1.0.0

## Description


Complete API for managing Italian Electronic Invoices (Fatturazione Elettronica) and Digital Receipts (Scontrino Elettronico) in full compliance with tax regulations.

### Core Capabilities
- **Electronic Invoicing**: Comprehensive management of both Active (outgoing) and Passive (incoming) invoices. Automates transmission to the SDI (Sistema di Interscambio), handles digital signatures, and monitors invoice states in real-time. 
  > **IMPORTANT**: To receive supplier invoices, you need to register our Recipient Code on the Italian Revenue Agency's website. Please follow this step-by-step guide and provide the following code when required: **PIC7CPS**
- **Digital Receipts**: Seamless integration for creating and transmitting Smart Electronic Receipts. Replaces traditional telematic cash registers for online sales, ensuring direct synchronization with the Government Tax Portal (Cassetto Fiscale).
- **Compliance & Security**: Adheres to Italian Revenue Agency (Agenzia delle Entrate) standards. Supports secure data exchange and flexible configuration management for different business entities.

**IMPORTANT**: Please note that you can not send Receipts between 23:55 and 00:00 (Italian Time Zone) to the Italian Revenue Agency (Agenzia delle Entrate). For this reason, all receipts sent in this time period will be sent at the first available time, i.e. in the first minutes of the new day.

**NB**: To use the receipt transmission service, you must enable your credentials on the Italian Revenue Agency (Agenzia delle Entrate) portal by following the third-party assignment procedure.
The same credentials enabled on the portal through this procedure must be entered into your **IT-configuration** (section `receipts_authentication`).

👉 **[CLICK HERE TO DOWNLOAD THE ENABLEMENT PROCEDURE GUIDE](https://docs.openapi.it/Procedura-manuale-per-incarico.pdf)**

*Note: Only companies have the ability to designate a third party for sending receipts. Freelancers (liberi professionisti) and sole proprietorships (aziende individuali) cannot appoint a third-party representative and must manage the transmission directly using their own credentials..*

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/IT-invoices` | Retrieve all IT-invoices. |
| POST | `/IT-invoices` | Create/Send an invoice. |
| GET | `/IT-invoices/{id}` | Retrieve a specific invoice. |
| POST | `/IT-invoices_import` | Import external invoice. |
| GET | `/IT-configurations` | Retrieve all IT-configurations. |
| POST | `/IT-configurations` | Create a new IT-configuration. |
| GET | `/IT-configurations/{fiscal_id}` | Retrieve a single IT-configuration by fiscal_id. |
| PATCH | `/IT-configurations/{fiscal_id}` | Update an existing IT-configuration. |
| DELETE | `/IT-configurations/{fiscal_id}` | Delete a IT-configuration by fiscal_id. |
| GET | `/IT-receipts` | Retrieve all IT-receipts. |
| POST | `/IT-receipts` | Create a new receipt. |
| GET | `/IT-receipts/{id}` | Retrieve a single receipt by ID. |
| PATCH | `/IT-receipts/{id}` | Return one or more items from a receipt. |
| DELETE | `/IT-receipts/{id}` | Delete a receipt by ID. |

---
<!-- source: knowledge/services/marchetemporali.md -->

# Marche Temporali

- **Base URL**: `https://ws.marchetemporali.com`
- **OAS file**: [`knowledge/oas/marchetemporali.openapi.json`](../oas/marchetemporali.openapi.json)
- **Version**: 1.0.0

## Description

This web service allows you to purchase time stamps and time stamp documents.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/marche` | List of your time stamps |
| GET | `/marche/{type}/{qty}` | Purchase of time stamps |
| GET | `/availability/{type}/{qty}` | Availability of time stamps |
| POST | `/check_lotto` | Control over consumption |
| POST | `/marca` | Time stamp a document |
| POST | `/analisi` | Analyze the marking |

---
<!-- source: knowledge/services/oauth.md -->

# Oauth

- **Base URL**: `https://oauth.openapi.it`
- **OAS file**: [`knowledge/oas/oauth.openapi.json`](../oas/oauth.openapi.json)
- **Version**: 1.0.0

## Description

Oauth is our essential authentication web service to use our services safely. Through this service you can receive, modify and see essential tokens to access all the rest methods of the bees that we provide. <br><br>Check out more at <a href="https://developers.openapi.it/services/oauth">https://developers.openapi.it/services/oauth</a><br>Explore all our services at <a href="https://developers.openapi.it/services">https://developers.openapi.it/services</a>

## Endpoints

| Method | Path | Summary |
|---|---|---|
| POST | `/token` | Create a token |
| GET | `/token` | List of all unexpired token |
| GET | `/token/{token}` | Finds a specific token |
| PUT | `/token/{token}` | Update the entire token object |
| PATCH | `/token/{token}` | Update part of token object |
| DELETE | `/token/{token}` | Delete a specific token |
| GET | `/scopes` | List of all scopes |
| GET | `/credit` | Your Openapi credit |
| GET | `/counters/total` | Your overall use |
| GET | `/counters/day/{day}` | Usage stats for a specific day |
| GET | `/counters/month/{month}` | Usage stats for a specific month |
| GET | `/counters/year/{year}` | Usage stats for a specific year |

---
<!-- source: knowledge/services/oauthv2.md -->

# Openapi OAuth Service

- **Base URL**: `https://oauth.openapi.com`
- **OAS file**: [`knowledge/oas/oauthv2.openapi.json`](../oas/oauthv2.openapi.json)
- **Version**: 2.1.0

## Description

Comprehensive OAuth management API that enables developers to create, manage, and monitor OAuth tokens with granular scope-based permissions. Features include token lifecycle management, usage statistics tracking, wallet-based billing, subscription handling, callback monitoring, and detailed analytics across multiple API domains.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| POST | `/tokens` | Create a new token |
| GET | `/tokens` | List or token detail |
| GET | `/scopes` | List of available scopes |
| GET | `/tokens/{token}` | Get token by ID |
| PATCH | `/tokens/{token}` | Update token by ID |
| DELETE | `/tokens/{token}` | Delete token by ID |
| GET | `/errors` | List error logs |
| GET | `/wallet` | Get wallet information |
| GET | `/callbacks` | List callbacks or get callback by ID |
| GET | `/stats` | Get overall API usage stats |
| GET | `/stats/ips` | Get list of unique IP addresses |
| GET | `/stats/apis` | Get stats grouped by API domain |
| GET | `/stats/apis/{domain}` | Get detailed stats for a specific API domain including scopes breakdown |
| GET | `/subscriptions` | List subscriptions or get subscription by ID |
| GET | `/scopes/{id}` | Get scope by ID |
| GET | `/callbacks/{id}` | Get callback by ID |
| GET | `/wallet/transactions` | Get wallet transactions history |
| GET | `/subscriptions/{id}` | Get subscription by ID |

---
<!-- source: knowledge/services/pdf.md -->

# HTML to PDF

- **Base URL**: `https://pdf.openapi.it`
- **OAS file**: [`knowledge/oas/pdf.openapi.json`](../oas/pdf.openapi.json)
- **Version**: 1.0.0

## Description

Generate a PDF document from a web page or an HTML string

## Endpoints

| Method | Path | Summary |
|---|---|---|
| POST | `/base` | Create a simple PDF file |

---
<!-- source: knowledge/services/pec.md -->

# Pec (Posta Elettronica Certificata)

- **Base URL**: `https://pec.openapi.it`
- **OAS file**: [`knowledge/oas/pec.openapi.json`](../oas/pec.openapi.json)
- **Version**: 1.0.0

## Description

Web service that allows you to activate a certified e-mail.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/domini_pec/{dominio}` | Domain check |
| GET | `/verifica_pec/{pec}` | Availability of a certified e-mail box |
| GET | `/pec` | List of your certified e-mail boxes |
| POST | `/pec` | Register a new certified mailbox |
| GET | `/pec/{id}` | Specific certified e-mail address |
| DELETE | `/pec/{id}` | Pec revocation |
| PATCH | `/pec/{id}/attivazione` | Certified e-mail activation |
| PATCH | `/pec/{id}/modifica` | Change mailbox space |
| PATCH | `/pec/{id}/conservazione` | Activation of conservation according to law |
| PATCH | `/pec/{id}/trasformazione` | Change box type |
| GET | `/pec/{id}/rinnovo` | Renewal of certified e-mail |
| POST | `/pec/{id}/multiutenza` | Add user |
| GET | `/comunica_pec` | List of your communications |
| POST | `/comunica_pec` | Communicate a certified e-mail |
| GET | `/comunica_pec/{id}` | Specific request for communication pec |
| PATCH | `/comunica_pec/{id}` | Upload the documents |
| GET | `/pec/{id}/modulo_attivazione` | Download the activation form |
| GET | `/pec/{id}/modulo_conservazione` | Download the activation form |
| GET | `/comunica_pec/{id}/procura_registro_imprese` | Download the power of attorney |

---
<!-- source: knowledge/services/pecmassiva.md -->

# PEC Massiva 1.0

- **Base URL**: `https://ws.pecmassiva.com`
- **OAS file**: [`knowledge/oas/pecmassiva.openapi.json`](../oas/pecmassiva.openapi.json)
- **Version**: 1.0.0

## Description

This service offers rest calls to send massive pecs and check the status of the delivery verification and receipt verification emails

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/send/{code}` | List of all the emails related to a given sending |
| DELETE | `/send/{code}` | Delete all the emails related to a given sending |
| POST | `/send` | Send a PEC to the recipient sent |
| GET | `/inbox/{id}` | Returns a single message in the INBOX |
| DELETE | `/inbox/{id}` | Delete an email |
| GET | `/inbox` | Get a list of emails in your inbox |
| GET | `/quota/{mailbox}` | Returns the usage of you INBOX |

---
<!-- source: knowledge/services/realestate.md -->

# Realestate

- **Base URL**: `https://realestate.openapi.com`
- **OAS file**: [`knowledge/oas/realestate.openapi.json`](../oas/realestate.openapi.json)
- **Version**: 1.0.0

## Description

The API provides endpoints for accessing real estate data, including comparable property data and property valuation information. Users can query the API using various criteria such as property type, location, and contract type to retrieve relevant data.  Overall, the API simplifies access to real estate data, making it easy for developers to integrate property information into their applications.


**IN SANDBOX**

 In the sandbox environment, consistent test data will be returned for API requests. This ensures predictability and facilitates testing and development processes. Users can rely on the sandbox environment to receive the same predefined data for various scenarios, allowing them to validate their application's functionality reliably without impacting live data or systems.


## Endpoints

| Method | Path | Summary |
|---|---|---|
| POST | `/IT-rmv` | Retrieve property transaction details and  information |
| POST | `/IT-sqm_value_start` | Retrieve basic property information |
| POST | `/IT-sqm_value_advanced` | Retrieve detailed property information including sales and demographic data |

---
<!-- source: knowledge/services/risk.md -->

# Risk

- **Base URL**: `https://risk.openapi.com`
- **OAS file**: [`knowledge/oas/risk.openapi.json`](../oas/risk.openapi.json)
- **Version**: 1.0.0

## Description

Web service that allows you to obtain a crif search on a person or a company and personal information about a natural or legal person such as personal data, telephones and the presence of negative events.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/IT-crif-persona` | List of your requests about the person |
| POST | `/IT-crif-persona` | Request for a crif search on a person |
| GET | `/IT-crif-persona/{id}` | Specific request |
| PATCH | `/IT-crif-persona/{id}` | Upload the delegation file |
| GET | `/IT-crif-persona/{id}/delega` | Download the delegation file |
| GET | `/IT-patrimoniale-persona` | List of your requests about the person |
| GET | `/IT-patrimoniale-persona/{id}` | Specific request |
| GET | `/IT-patrimoniale-persona/{id}/download` | This method allows you to directly download the pdf file with the required data. |
| POST | `/IT-patrimoniale-persona/` | Request for a patrimoniale search on a person |
| GET | `/IT-patrimoniale-persona-top` | List of your requests about the person |
| GET | `/IT-patrimoniale-persona-top/{id}` | Specific request |
| GET | `/IT-patrimoniale-persona-top/{id}/download` | This method allows you to directly download the pdf file with the required data. |
| POST | `/IT-patrimoniale-persona-top/` | Request for a patrimoniale search on a person |
| GET | `/IT-report-persona-top` | List of your requests about the person |
| GET | `/IT-report-persona-top/{id}` | Specific request |
| GET | `/IT-report-persona-top/{id}/download` | This method allows you to directly download the pdf file with the required data. |
| POST | `/IT-report-persona-top/` | Request for a patrimoniale search on a person |
| GET | `/IT-report-persona` | List of your requests about the person |
| GET | `/IT-report-persona/{id}` | Specific request |
| GET | `/IT-report-persona/{id}/download` | This method allows you to directly download the pdf file with the required data. |
| POST | `/IT-report-persona/` | Request for a report-persona search on a person |
| GET | `/IT-eredi-con-accettazione` | List of your requests about the person |
| GET | `/IT-eredi-con-accettazione/{id}` | Specific request |
| GET | `/IT-eredi-con-accettazione/{id}/download` | This method allows you to directly download the pdf file with the required data. |
| POST | `/IT-eredi-con-accettazione/` | Request for a eredi-con-accettazione to search on a person |
| GET | `/IT-eredi-senza-accettazione` | List of your requests about the person |
| GET | `/IT-eredi-senza-accettazione/{id}` | Specific request |
| GET | `/IT-eredi-senza-accettazione/{id}/download` | This method allows you to directly download the pdf file with the required data. |
| POST | `/IT-eredi-senza-accettazione/` | Request for a eredi-senza-accettazione to search on a person |
| GET | `/IT-report-azienda` | List of your requests about the company |
| GET | `/IT-report-azienda/{id}` | Specific request |
| GET | `/IT-report-azienda/{id}/download` | This method allows you to directly download the pdf file with the required data. |
| POST | `/IT-report-azienda/` | Request for a report-azienda to search on a person |
| GET | `/IT-report-azienda-top` | List of your requests about the company |
| GET | `/IT-report-azienda-top/{id}` | Specific request |
| GET | `/IT-report-azienda-top/{id}/download` | This method allows you to directly download the pdf file with the required data. |
| POST | `/IT-report-azienda-top/` | Request for a report-azienda-top to search on a person |
| GET | `/IT-crif-azienda` | List of your requests about the company |
| POST | `/IT-crif-azienda` | Request for a crif search on a company |
| GET | `/IT-crif-azienda/{id}` | Specific request |
| PATCH | `/IT-crif-azienda/{id}` | Upload the delegation file |
| GET | `/IT-crif-azienda/{id}/delega` | Download the delegation file |
| GET | `/IT-verifica_cf/{codice_fiscale}` | Check fiscal code |
| GET | `/IT-creditscore-start/{vatCode_taxCode_or_id}` | Check risk score |
| GET | `/IT-creditscore-advanced/{vatCode_taxCode_or_id}` | Check risk score |
| GET | `/IT-creditscore-top/{vatCode_taxCode_or_id}` | Check risk score |
| GET | `/IT-richiesta` | List of your requests |
| GET | `/IT-richiesta/{id}` | Specific request |
| GET | `/IT-richiesta/{id}/download` | Download pdf report |
| POST | `/IT-negativita` | Create a request |
| GET | `/IT-negativita/{id}/dettaglio` | Negativity detail |
| POST | `/WW-kyc-full` | Create a full kyc request |
| POST | `/WW-kyc-pep` | Create a pep kyc request |
| POST | `/WW-kyc-sanction_list` | Create a sanction_list kyc request |
| POST | `/WW-kyc-adverse_media` | Create a adverse_media kyc request |
| GET | `/WW-kyc-evidences` | List of your kyc requests |
| GET | `/WW-kyc-evidences/{id}` | Specific kyc request |
| GET | `/WW-kyc-evidences/{id}/{entity_id}` | Get entity evidences |
| POST | `/WW-kyc-full-monitor` | Create a full kyc monioring |
| GET | `/WW-kyc-full-monitor` | List of your kyc monitoring |
| GET | `/WW-kyc-full-monitor/{id}` | Specific kyc monitoring |
| DELETE | `/WW-kyc-full-monitor/{id}` | Delete kyc monitoring |

---
<!-- source: knowledge/services/sdi.md -->

# SDI

- **Base URL**: `https://sdi.openapi.it`
- **OAS file**: [`knowledge/oas/sdi.openapi.json`](../oas/sdi.openapi.json)
- **Version**: 1.0.0

## Description

This service allows you to handle interactions with the Italian SDI (Sistema Di Interscambio)

 You can configure your account to send invoices directly to the legal storage by setting the api_configuration to your needs

## Before we begin

In order to receive supplier invoices, you need to register our Recipient Code on the Italian Revenue Agency's website. Please follow this step-by-step guide and provide the following code when required: JKKZDGR

 ## Get started:


1. Create an BusinessRegistryConfiguration with <b>POST /business_registry_configurations</b> for your <em>fiscal_id</em> and your *email*

1. A mail will be sent to your address to activate the account on the legal storage platform, if required.

1. Create an ApiConfiguration for your BusinessRegistryConfiguration with <b>POST /api_configurations</b>.
 This endpoint can be configured to receive all the notifications with a callback.

1. Create an XML invoice on the endpoint relative to your configuration

To see an example of the callback objects, plese check the **Callbacks** tab in the `/api_configurations` request<br><br><br>Please note that in the English translation:

<b>Customer invoices: Fatture attive</b>

<b>Supplier invoices: Fatture passive</b>

<b>Legal storage: Certificazione a norma</b>

## Interacting with the legal storage 

Legal Storage is the service that enables the legal preservation for your documents. All the stored documents are available into the legal storage management software, a third party software.

When creating a BusinessRegistryConfiguration, you will be asked to provide an email address which will be registed on the platform. You will receive an email containing all the steps to complete the registration and access the platform.

## Reactivating a BusinessRegistryConfiguration
If you receive a callback but you have no credit left on your wallet, your account will be temporarily suspended: when this happens, you will be sent a reminder email immediately. In order to re-activate it after a wallet recharge, you would need to submit a PATCH request to `/business_registry_configurations/{fiscal_id}/activate`

 ## Interacting with the Public Administration (PA)

Invoices to the Public Administration are automatically detected and signed.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| POST | `/business_registry_configurations` | Create a Business Registry Configuration  |
| GET | `/business_registry_configurations` | Retrieve a list of Business Registry Configuration  |
| GET | `/business_registry_configurations/{fiscal_id}` | Retrieve a Business Registry Configuration  |
| DELETE | `/business_registry_configurations/{fiscal_id}` | Delete a Business Registry Configuration  |
| PATCH | `/business_registry_configurations/{fiscal_id}/activate` | Re-activate a Business Registry Configuration  |
| POST | `/api_configurations` | Create an ApiConfiguration for a fiscal_id |
| GET | `/api_configurations` | Retrieve a list of ApiConfigurations |
| DELETE | `/api_configurations/{id}` | Delete of ApiConfigurations |
| POST | `/invoices` | Create an invoice |
| GET | `/invoices` | Retrieve collection of Invoice resources. |
| POST | `/invoices_signature` | Create an invoice applying the signature |
| POST | `/invoices_legal_storage` | Create an invoice applying legal storage |
| POST | `/invoices_signature_legal_storage` | Create an invoice applying the signature and legal storage |
| GET | `/invoices/{uuid}` | Retrieve Invoice resource. |
| GET | `/invoices_download/{uuid}` | Download a Invoice resource. |
| GET | `/invoices_notifications/{uuid}` | Retrieve collection of Invoice notifications. |
| POST | `/customer_invoice_imports` | Import customer invoice (fattura attiva) |
| POST | `/supplier_invoice_imports` | Import supplier invoice (fattura passiva) |
| POST | `/customer_invoice_imports_legal_storage` | Import customer invoice (fattura attiva) |
| POST | `/supplier_invoice_imports_legal_storage` | Import supplier invoice (fattura passiva) |
| POST | `/simulate/{type}` | Service Simulate |

---
<!-- source: knowledge/services/smsv2.md -->

# Gateway SMS

- **Base URL**: `https://sms.openapi.com`
- **OAS file**: [`knowledge/oas/smsv2.openapi.json`](../oas/smsv2.openapi.json)
- **Version**: 1.2.7

## Description

The Gateway SMS API by Openapi provides a robust and scalable solution for integrating professional SMS messaging into your applications. Our service is designed to handle high volumes of messages with precision, offering dedicated endpoints for specific regions like Italy and Spain, as well as a Worldwide endpoint for global reach.

Each request undergoes a rigorous validation process that includes syntax checking for E.164 formats, character encoding detection (GSM-7 or UCS-2), and automatic segmentation for long messages. We prioritize security and compliance: the system automatically scans content for forbidden words to prevent abuse and ensures that all messages comply with legal requirements.

Developers can benefit from advanced features such as 'Dry Run' for testing without incurring costs, and real-time Webhook callbacks that provide immediate updates on delivery status. Messages have a maximum expiration time of 48 hours; if a message cannot be delivered within this window, its status will change to EXPIRED. Billing is transparent and dynamic; while regional messages have fixed rates, worldwide delivery costs are calculated post-sending to ensure the best market price. Please note that maintaining a minimum credit balance is required for worldwide operations, and strict penalties apply for policy violations to ensure the highest quality of service for all users.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| POST | `/WW-messages` | Send a new SMS message (Worldwide) |
| POST | `/IT-messages` | Send a new SMS message (Italy) |
| POST | `/ES-messages` | Send a new SMS message (Spain) |
| POST | `/otp` | Send an OTP verification message |
| GET | `/messages` | Retrieve the list of sent messages |
| GET | `/messages/{id}` | Retrieve a single message |

---
<!-- source: knowledge/services/trust.md -->

# Trust

- **Base URL**: `https://trust.openapi.com`
- **OAS file**: [`knowledge/oas/trust.openapi.json`](../oas/trust.openapi.json)
- **Version**: 1.0.0

## Description

Use this API to verify the validity and trustworthiness of data such as email addresses and mobile phone numbers.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/mobile-start/{id}` | Retrive a request |
| POST | `/mobile-start/{mobile-phone-number}` | Create a new HLR request |
| GET | `/email-start/{id}` | Retrieve an email validation request |
| POST | `/email-start/{email}` | Create a new email validation request |
| GET | `/mobile-advanced/{id}` | Retrieve an advanced mobile phone validation request |
| POST | `/mobile-advanced/{mobile-phone-number}` | Create a new advanced mobile phone validation request |
| GET | `/email-advanced/{id}` | Retrieve an advanced email validation request |
| POST | `/email-advanced/{email}` | Create a new advanced email validation request |
| GET | `/ip-advanced/{id}` | Retrieve an advanced IP analysis request |
| POST | `/ip-advanced/{ip}` | Create a new advanced IP analysis request |
| GET | `/url-advanced/{id}` | Retrieve an advanced URL scan request |
| POST | `/url-advanced/{url}` | Create a new advanced URL scan request |
| GET | `/idv-flash-start/{id}` | Retrieve an Identity Verification request |
| GET | `/idv-flash-advanced/{id}` | Retrieve an Advanced Identity Verification request |
| GET | `/idv-expert/{id}` | Retrieve an Expert Identity Verification request |
| GET | `/idv-flash-start/{id}/front` | Retrieve document front image |
| GET | `/idv-flash-start/{id}/back` | Retrieve document back image |
| GET | `/idv-flash-advanced/{id}/front` | Retrieve document front image |
| GET | `/idv-flash-advanced/{id}/back` | Retrieve document back image |
| GET | `/idv-flash-advanced/{id}/face` | Retrieve face capture image |
| GET | `/idv-expert/{id}/front` | Retrieve document front image |
| GET | `/idv-expert/{id}/back` | Retrieve document back image |
| GET | `/idv-expert/{id}/face` | Retrieve face capture image |
| POST | `/idv-flash-start` | Create a new Identity Verification request |
| POST | `/idv-flash-advanced` | Create a new Advanced Identity Verification request |
| POST | `/idv-expert` | Create a new Expert Identity Verification request |

---
<!-- source: knowledge/services/ufficiopostale.md -->

# Ufficio Postale

- **Base URL**: `https://ws.ufficiopostale.com`
- **OAS file**: [`knowledge/oas/ufficiopostale.openapi.json`](../oas/ufficiopostale.openapi.json)
- **Version**: 1.1.0

## Description

This web service allows the delivery of postal products like Raccomandate, Telegrammi, Posta Prioritaria through Poste Italiane <ol><li>Create a new mail with a POST request</li><li>Check the prices and confirm it with a PATCH, or use <em>autoconfirm: true</em></li><li>Receive the status updates of your mail by providing a <em>callback</em> url</li></ol> <br> <strong>Note: </strong> There are some limitations regarding the size of a PDF document. Please read the 'document' field in the description of the endpoint that you want to use. <br><br> <h2>Error handling</h2> When a sending error occurs, the response will include a <code>message</code> and a <code>data.wrong_fields: []</code>: each element of <code>wrong_fields</code> is a string which indicates where the error was generated from. This makes it very easy to integrate in your front-end form, where you can highlight the wrong entries<h2>Testing</h2>When using the Sandbox environment, you will receive update callbacks a short time after creating the request with placeholder content. It is also possible, for some products, to force the execution of the callback in the sandbox environment.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/telegrammi/{id}` | Get information about a telegram |
| PATCH | `/telegrammi/{id}` | Confirm send of a telegram |
| GET | `/telegrammi/{id}/accettazione` | Download accettazione Telegrammi |
| GET | `/telegrammi/` | List your telegrams |
| POST | `/telegrammi/` | Create your request |
| GET | `/pricing/` | Get pricings |
| GET | `/pricing/{service}` | Get pricing for a specific service |
| GET | `/nazioni/{service}` | Get countries list |
| GET | `/nazioni/` | Get full countries list |
| GET | `/covers/` | Get all cover configurations |
| POST | `/covers/` | Create a new cover |
| GET | `/covers/{id}` | Get specific cover configuration |
| GET | `/covers/{id}/preview` | Get specific cover preview |
| GET | `/dug/` | List of all available dugs |
| GET | `/posta_massiva_top/` | List your Posta Massiva Top |
| POST | `/posta_massiva_top/` | Create your request |
| GET | `/posta_massiva_top/{id}` | List your single Posta Massiva Top |
| PATCH | `/posta_massiva_top/{id}` | Confirm send Posta Massiva Top |
| GET | `/posta_massiva_top/{id}/accettazione` | Download accettazione Posta Massiva Top |
| GET | `/posta_massiva/` | List your Posta Massiva |
| POST | `/posta_massiva/` | Create your request |
| GET | `/posta_massiva/{id}` | List your single Posta Massiva |
| PATCH | `/posta_massiva/{id}` | Confirm send Posta Massiva |
| GET | `/posta_massiva/{id}/accettazione` | Download accettazione Posta Massiva |
| GET | `/raccomandate_smart/` | List your raccomandate_smart |
| POST | `/raccomandate_smart/` | Create your request |
| GET | `/raccomandate_smart/{id}` | List your single raccomandata smart |
| PATCH | `/raccomandate_smart/{id}` | Confirm send Raccomandata Smart |
| GET | `/raccomandate_smart/{id}/accettazione` | Download accettazione Raccomandata Smart |
| GET | `/raccomandate/` | List your Raccomandate |
| POST | `/raccomandate/` | Create your request |
| GET | `/atti_giudiziari/{id}/destinatari/{IdDestinatario}/archiviazione` | Download archiviazione Atti Giudiziari |
| GET | `/atti_giudiziari/{id}/destinatari/{IdDestinatario}/ardigitale` | Download Digital Return Receipt (AR Digitale) |
| GET | `/atti_giudiziari/{id}/accettazione` | Download accettazione Atti Giudiziari |
| GET | `/atti_giudiziari/{id}` | Get information about a Atto Giudiziaro |
| PATCH | `/atti_giudiziari/{id}` | Confirm send Atti Giudiziari |
| GET | `/atti_giudiziari/` | List your Atti Giudiziari |
| POST | `/atti_giudiziari/` | Create your request |
| GET | `/ordinarie/` | List your requests |
| POST | `/ordinarie/` | Create your request |
| GET | `/ordinarie/{id}/destinatari/{IdDestinatario}/archiviazione` | Download archiviazione Ordinaria |
| GET | `/ordinarie/{id}` | Get information about a single mail |
| PATCH | `/ordinarie/{id}` | Confirm send Posta Ordinaria |
| GET | `/ordinarie/{id}/accettazione` | Download accettazione Posta Ordinaria |
| GET | `/prioritarie/` | List your requests |
| POST | `/prioritarie/` | Create your request |
| GET | `/prioritarie/{id}/destinatari/{IdDestinatario}/archiviazione` | Download archiviazione Prioritarie |
| GET | `/prioritarie/{id}` | Get information about a single priority mail |
| PATCH | `/prioritarie/{id}` | Confirm send Posta Prioritaria |
| GET | `/prioritarie/{id}/accettazione` | Download accettazione Posta Prioritaria |
| GET | `/raccomandate/{id}/destinatari/{IdDestinatario}/archiviazione` | Download archiviazione Raccomandata |
| GET | `/raccomandate/{id}/accettazione` | Download accettazione Raccomandate |
| GET | `/raccomandate/{id}` | Get information about a Raccomandata |
| PATCH | `/raccomandate/{id}` | Confirm send Posta Raccomandate |
| GET | `/tracking/{id}` | Track your product |

---
<!-- source: knowledge/services/visengine.md -->

# Visengine 2.0

- **Base URL**: `https://visengine2.altravia.com`
- **OAS file**: [`knowledge/oas/visengine.openapi.json`](../oas/visengine.openapi.json)
- **Version**: 2.0.0

## Description

This service offers rest calls to take advantage of a whole series of chamber of commerce, cadastral or patronage services linked to businesses and individuals

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/visure` | List of all services |
| GET | `/visure/{hash_visura}` | Service identified with hash_visura |
| GET | `/richiesta` | List of all requests |
| POST | `/richiesta` | Creating a request |
| GET | `/richiesta/{_id}` | Finds request by _id |
| POST | `/richiesta/{_id}` | Add a search to the request |
| PUT | `/richiesta/{_id}` | Updates the request |
| PUT | `/richiesta/{_id}/ricerche` | Updates the request with the chosen index and search |
| GET | `/documento/{_id}` | Document generated by the request |

---
<!-- source: knowledge/services/visurecamerali.md -->

# Visure Camerali

- **Base URL**: `https://visurecamerali.openapi.it`
- **OAS file**: [`knowledge/oas/visurecamerali.openapi.json`](../oas/visurecamerali.openapi.json)
- **Version**: 1.0.0

## Description

Web service that allows you to obtain a company registration certificate or the financial statements.

## Endpoints

| Method | Path | Summary |
|---|---|---|
| GET | `/impresa` | Business search |
| GET | `/impresa/{cf_piva_id}` | Business search |
| GET | `/ordinaria-impresa-individuale` | List of your requests |
| POST | `/ordinaria-impresa-individuale` | Generates a request |
| GET | `/ordinaria-impresa-individuale/{id}` | Specific request |
| GET | `/ordinaria-impresa-individuale/{id}/allegati` | Download the document |
| GET | `/storica-impresa-individuale` | List of your requests |
| POST | `/storica-impresa-individuale` | Generates a request |
| GET | `/storica-impresa-individuale/{id}` | Specific request |
| GET | `/storica-impresa-individuale/{id}/allegati` | Download the document |
| GET | `/ordinaria-societa-capitale` | List of your requests |
| POST | `/ordinaria-societa-capitale` | Generates a request |
| GET | `/ordinaria-societa-capitale/{id}` | Specific request |
| GET | `/ordinaria-societa-capitale/{id}/allegati` | Download the document |
| GET | `/storica-societa-capitale` | List of your requests |
| POST | `/storica-societa-capitale` | Generates a request |
| GET | `/storica-societa-capitale/{id}` | Specific request |
| GET | `/storica-societa-capitale/{id}/allegati` | Download the document |
| GET | `/ordinaria-societa-persone` | List of your requests |
| POST | `/ordinaria-societa-persone` | Generates a request |
| GET | `/ordinaria-societa-persone/{id}` | Specific request |
| GET | `/ordinaria-societa-persone/{id}/allegati` | Download the document |
| GET | `/storica-societa-persone` | List of your requests |
| POST | `/storica-societa-persone` | Generates a request |
| GET | `/storica-societa-persone/{id}` | Specific request |
| GET | `/storica-societa-persone/{id}/allegati` | Download the document |
| GET | `/bilancio-ottico` | List of your requests |
| POST | `/bilancio-ottico` | Generates a request |
| GET | `/bilancio-ottico/{id}` | Specific request |
| GET | `/bilancio-ottico/{id}/allegati` | Download the document |
| GET | `/certificato-iscrizione` | List of your requests |
| POST | `/certificato-iscrizione` | Generates a request |
| GET | `/certificato-iscrizione/{id}` | Specific request |
| GET | `/certificato-iscrizione/{id}/allegati` | Download the document |
| GET | `/certificato-iscrizione-vigenza` | List of your requests |
| POST | `/certificato-iscrizione-vigenza` | Generates a request |
| GET | `/certificato-iscrizione-vigenza/{id}` | Specific request |
| GET | `/certificato-iscrizione-vigenza/{id}/allegati` | Download the document |
| GET | `/soci-attivi` | List of your requests |
| POST | `/soci-attivi` | Generates a request |
| GET | `/soci-attivi/{id}` | Specific request |
| GET | `/soci-attivi/{id}/allegati` | Download the document |

Download now (ZIP)

  • In this repositoryOne other file it gives its agents.

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.