Il service “Imprese Forma Giuridica” è composto da due endpoint:

1) Forma Giuridica GET /forma_giuridica

Con Imprese Forma Giuridica ottieni l'elenco e il codice di tutte le forme giuridiche d'impresa (ovvero il modello organizzativo, amministrativo, fiscale e contabile con cui viene condotta un'azienda, in base alle norme del Codice Civile). Sono possibili varie forme, alle quali corrispondono specifici codici di natura giuridica. Ecco alcuni esempi:

• Fondazione (FO)
• Società per Azioni (SP)
• Società a Responsabilità limitata (SR)
• Istituto di Credito (IC)

Imprese Forma Giuridica è identificato dall’endpoint: GET https://imprese.openapi.it/forma_giuridica

La risposta è in tempo reale.

ESEMPIO CHIAMATA GET /forma_giuridica

Questo è un esempio di richiesta

https://imprese.openapi.it/forma_giuridica

ESEMPIO RISPOSTA GET /forma_giuridica

La risposta fornisce l'elenco completo delle sigle e delle forme giuridiche:

• “codice natura giuridica”: si tratta di una sigla, es. AA, AN, EI
• “valore”: indica il valore della sigla, quindi ad esempio AA sta per SOCIETÀ IN ACCOMANDITA PER AZIONI, AN per SOCIETÀ CONSORTILE IN NOME COLLETTIVO, etc.

{
  "data": [
    {
      "codice_natura_giuridica": "AA",
      "valore": "SOCIETA' IN ACCOMANDITA PER AZIONI"
    },
    {
      "codice_natura_giuridica": "AN",
      "valore": "SOCIETA' CONSORTILE IN NOME COLLETTIVO"
    },
    {
      "codice_natura_giuridica": "EI",
      "valore": "ENTE IMPRESA"
    },
    {
      "codice_natura_giuridica": "RR",
      "valore": "SOCIETA' A RESPONSABILITA' LIMITATA A CAPITALE RIDOTTO"
    }
  ],
  "success": true,
  "message": "",
  "error": null
}

L'elenco della risposta è solo a titolo di esempio e non completo.

2) Codice Natura Giuridica GET /forma_giuridica/{codice_natura_giuridica} 

Il service "Codice Natura Giuridica" consente di avere informazioni circa la forma giuridica di un’impresa. Si tratta di un dato reso disponibile a partire dal parametro Codice Natura Giuridica, che viene fornito via API ed in tempo reale.

Imprese Codice Natura Giuridica è identificato dall’endpoint: GET https://imprese.openapi.it/forma_giuridica/{codice_natura_giuridica}

La risposta è in real time.

ESEMPIO CHIAMATA 
GET /forma_giuridica/{codice_natura_giuridica}

La chiamata può essere effettuata inserendo come parametro di partenza il “codice_natura_giuridica” (as esempio SP).

https://imprese.openapi.it/forma_giuridica/SP

ESEMPIO RISPOSTA 
GET /forma_giuridica/{codice_natura_giuridica}

La risposta fornisce dettagli su:

• “codice natura giuridica”: si tratta di una sigla, es. SP
• “valore”: indica il valore della sigla, quindi ad esempio SP sta per SOCIETÀ PER AZIONI, etc.

{
  "data": [
    {
      "codice_natura_giuridica": "SP",
      "valore": "SOCIETA' PER AZIONI"
    },
  "success": true,
  "message": "",
  "error": null
}

Tutti gli Endpoint dell'API Imprese

L'API Imprese consente di accedere, in base all'endpoint utilizzato, da singole informazioni sull'azienda, come ad esempio PEC e codice destinatario, a dataset più completi come quelli di Imprese Base o Advance:

• Imprese Advance (Elenco) per avere un elenco di imprese in base ad una serie di parametri come codice ateco, fatturato, CCIAA, dipendenti
• Imprese Advance Partita IVA per ottenere informazioni dettagliate su aziende come fatturato, utili, pec dipendenti, capitale sociale, stato presso Agenzia Entrate, soci
• Imprese Autocomplete per ottenere un elenco di nomi di aziende a partire da una query (una o più parole)
• Imprese Base per ottenere informazioni fondamentali sulle aziende italiane come ad esempio denominazione sociale, sede, codice destinatario e stati attività
• Imprese Cessata per verificare lo stato di un'impresa presso l'Agenzia delle Entrate
• Imprese Codice Destinatario per ottenere il codice SdI di un'impresa
• Imprese Gruppo IVA per verificare se un'impresa appartiene ad Gruppo IVA
• Imprese PEC per scoprire la PEC di un’azienda
• Imprese Soci per ottenere l’elenco dei soci di un’impresa
• Imprese Updates per avere l'elenco di tutti gli id delle aziende per cui sono state registrate delle modifiche