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

1) Forma Giuridica GET /forma_giuridica

Con il service “Cerca 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)

Il “Cerca 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.

Il “Cerca 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
}

Altri Endpoint del Service Cerca Imprese

Il service Cerca Imprese permette attraverso altri endpoint di ottenere singole informazioni già presenti nel Cerca Imprese Base e Advance:

• Cerca Imprese Advance (Elenco) per ottenere un elenco di imprese in base ad una serie di parametri come codice ateco, fatturato, cciaa, dipendenti
• Cerca Imprese Advance Partita IVA per ottenere informazioni dettagliate su un’azienda
• Cerca Imprese Attiva/Chiusa per verificare lo stato di un’azienda
• Cerca Imprese Autocomplete per ottenere un elenco di nomi di aziende a partire da una ricerca parole
• Cerca Imprese Base per ottenere informazioni specifiche sulle aziende italiane
• Cerca Imprese Gruppo IVA per verificare se un'impresa appartiene ad Gruppo IVA
• Cerca Imprese PEC per scoprire la PEC di un’azienda
• Cerca Imprese Soci per ottenere l’elenco dei soci di un’impresa
• Cerca Imprese Updates per avere l'elenco di tutti gli id delle aziende per cui sono state registrate delle modifiche