Welcome!

This API provides you with fast and efficient access to detailed information about companies in Romania, using the unique tax identification code (CIF). Whether you need data for analysis, verification, or integration into your own system, our API is the ideal solution.

🚀 Available Features:

• Company Information – Quickly obtain details about any company in Romania based on its CIF.
• Counties Directory – Access the complete list of Romanian counties, updated and structured.
• Localities Directory – Explore all cities, communes, and villages in Romania in an organized and easy-to-use format.

🔎 Benefits:

• Fast access to organized administrative data.
• Standardization according to official regulations.
• Easy to integrate into any system or platform.
• All responses are in JSON format.

The API is designed to be fast, reliable, and easy to integrate into any application or platform.

Start now and discover the power of well-organized data! 🚀

Authentication

Access to the data provided through this API is done using an account (username and password) via the Basic Auth method.

To obtain an account, username, and password, create an account on iapp.ro and then visit the API Company Information page and follow the steps to generate them.

For more information, please use the contact methods provided below.

Company Information

Get information about a company in Romania based on its CIF.

POST /companie

POST Parameters:

• "cif" - integer or string value, e.g.: 14399840 or RO14399840;

Code Example (PHP):

<?php

    $url = "https://api.inap.ro/companie";
    
    $curl = curl_init($url);
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_POST, true);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    
    $headers = array(
       "Authorization: Basic ".base64_encode("{USERNAME}:{PASSWORD}"),
       "Content-Type: application/json",
    );
    curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
    
    $data = '{"cif": "14399840"}';
    
    curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
    $resp = curl_exec($curl);
    curl_close($curl);
    var_dump($resp);
    

Code Example (Python):

import requests
import base64
from requests.structures import CaseInsensitiveDict

auth_string = f"{USERNAME}:{PASSWORD}"
auth_encoded = base64.b64encode(auth_string.encode()).decode()

headers = CaseInsensitiveDict()
headers["Authorization"] = f"Basic {auth_encoded}"
headers["Content-Type"] = "application/json"

url = "https://api.inap.ro/companie"
data = '{"cif": "14399840"}'
resp = requests.post(url, headers=headers, data=data)

# Display the response code
print(resp.status_code)
print(resp.text)
    

Response Example (JSON):

{
    "status": "SUCCESS",
    "error_code": "000",
    "message": "Informațiile au fost afisate cu succes.",
    "request": "companie",
    "data": {
        "input": {
            "cif": 14399840
        },
        "output": {
            "nume": "DANTE INTERNATIONAL SA",
            "cif": "14399840",
            "regcom": "J40/372/2002",
            "euid": "ROONRC.J40/372/2002",
            "tva": "Y",
            "caen": "",
            "data_inregistrare": "",
            "adresa": {
                "tara": "România",
                "judet_cod": "Bucureşti",
                "judet": "Bucureşti",
                "oras": "SECTOR6",
                "adresa": "Şos. VIRTUŢII, Nr. 148, spatiul E47, Cod poștal 60787"
            },
            "activa": "da",
            "actualizare": "2024-12-18 00:00",
            "stare": {
                "cod": "1048",
                "text": ""
            }
        }
    }
}

Counties and Localities Directory for Romania

Our API provides access to a complete and up-to-date directory of counties and localities in Romania. This data is essential for any application that requires precise territorial organization, whether it involves address management, information validation, or geographic analysis.

📌 What information is available?

• Counties Directory – The complete list of Romanian counties, each identified by a unique code and a standardized name.
• Localities Directory – Includes cities, communes, and villages, each associated with the corresponding county.

This information is structured to be easy to use, both for quick lookups and for advanced integrations in software applications.

POST /nomenclator/judete

This request provides the list of counties and the code associated with each one.

No parameters are required.

Code Example (PHP):

<?php

    $url = "https://api.inap.ro/nomenclator/judete";
    
    $curl = curl_init($url);
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_POST, true);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    
    $headers = array(
       "Authorization: Basic ".base64_encode("{USERNAME}:{PASSWORD}"),
       "Content-Type: application/json",
    );
    curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
    
    $resp = curl_exec($curl);
    curl_close($curl);
    var_dump($resp);
    

Response Example (JSON):

{
    "status": "SUCCESS",
    "error_code": "000",
    "message": "",
    "request": "nomenclator/judete",
    "data": {
        "output": [{
                "cod": "1",
                "auto": "AB",
                "name": "ALBA",
                "sort": "1"
            },
            {
                "cod": "2",
                "auto": "AR",
                "name": "ARAD",
                "sort": "2"
            },
            ...
        ]
    }
}

POST /nomenclator/localitati

This request provides the list of cities / communes / villages, associated with the county you selected.

POST Parameters:

• "cod" - integer value, represents the code associated with the county for which the directory is requested;

{ "cod": {NUMBER} }

Code Example (PHP):

<?php

    $url = "https://api.inap.ro/nomenclator/localitati";
    
    $curl = curl_init($url);
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_POST, true);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    
    $headers = array(
       "Authorization: Basic ".base64_encode("{USERNAME}:{PASSWORD}"),
       "Content-Type: application/json",
    );
    curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
    
    $data = '{"cod": 1}';
    
    curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
    $resp = curl_exec($curl);
    curl_close($curl);
    var_dump($resp);
    

Response Example (JSON):

{
    "status": "SUCCESS",
    "error_code": "000",
    "message": "",
    "request": "nomenclator/localitati",
    "data": {
        "input": {
            "cod": 52
        },
        "output": [{
                "cod": "2",
                "cod_parinte": "0",
                "tip": "Com",
                "name": "Adunaţii-Copăceni",
                "postal": "87005"
            },
            {
                "cod": "1",
                "cod_parinte": "2",
                "tip": "Sat",
                "name": "Adunaţii-Copăceni",
                "postal": "87005"
            },
            ...
        ]
    }
}

API Error Codes Explanation

Our API returns an error code and a descriptive message for each response, so that users can quickly understand the result of the request made.

These error codes are essential for diagnosing issues encountered when using the API and for taking the necessary steps to correct them. The message associated with each code provides clear details about the nature of the error, facilitating the integration and debugging of applications that use the API.

Error Codes List

Contact

Create a ticket: developer.iapp.ro

Email address: support@iapp.ro

Phone: +40 773 334 875

WhatsApp: +40 770 846 823

Website: iapp.ro