Matchplat API Docs

Company Object

The `company` object is the core of the Matchplat Explore APIs. Here you find a detailed description of all available fields, their meaning, and a sample JSON structure.

Main fields

Field Type Description
addressLine1/2/3/4 String The company's registered address
categoryOfTheCompany String Company size category (see details below)
city String City of the registered office
cityNative String City in local language (e.g. ideograms for Chinese companies)
countryIso2 String ISO2 code of the country
dateOfIncorporation String (ISO datetime) Company foundation date
fax String Fax number as registered
id String Unique identifier in the Matchplat database
identifiers Object[] Fiscal and registry identifiers (see details below)
naceCore String[] NACE macro category
naceMain String[] NACE main section
nacePrimary String[] Primary NACE code (4 digits)
naicsCore String[] General NAICS code (4 digits)
naicsPrimary String[] Primary NAICS code (6 digits)
nameInternational String Company name normalized to western characters
nameNative String Company name in local language
nationalCodeType String[] Type of industry code used in the country.
nationalPrimary String[] The company's primary industry code in its local classification (e.g. ATECO in Italy). If multiple, matches 1:1 with nationalCodeType
nuts1/2/3 String Nomenclature of territorial units for statistics (EU statistical regions)
phone String Company phone number as registered
postcode String Postal code of the registered office (where available)
region String Region of the registered office. String format described in typeOfRegion
sicCore String[] SIC core code (3 digits)
sicPrimary String[] SIC primary code (4 digits)
status String Company activity status (see details below)
typeOfRegion String Describes the format of the region field
usMetropolitanArea String Metropolitan area (USA only) where the company is located
usState String US state of the registered office (also found in region)
website String Main company website

Detail categoryOfTheCompany

Detail identifiers

Each element of the identifiers array contains:

Field Description
nationalIdLabel Local label of the fiscal identifier
nationalIdNumber Identifier number
nationalIdTypes Normalized category (e.g. VAT/Tax number, Trade register number, etc.)

Possible values for nationalIdTypes

Possible labels for nationalIdLabel

Detail status

Possible status values

JSON Example

{
  "addressLine1": "Via Lega Lombarda 6",
  "addressLine2": "",
  "addressLine3": "",
  "addressLine4": "",
  "categoryOfTheCompany": "Medium sized company",
  "city": "Adro",
  "cityNative": "Adro",
  "countryIso2": "IT",
  "county": "Western Europe",
  "dateOfIncorporation": "2017-09-29T00:00:00+00:00",
  "fax": "",
  "id": "IT03939130989",
  "identifiers": [
    {
      "nationalIdLabel": "TIN, Partita IVA, Codice fiscale",
      "nationalIdNumber": "03939130989",
      "nationalIdTypes": [
        "TIN",
        "VAT/Tax number"
      ]
    },
    {
      "nationalIdLabel": "CCIAA number",
      "nationalIdNumber": "BS0575512",
      "nationalIdTypes": [
        "Trade register number"
      ]
    },
    {
      "nationalIdLabel": "European VAT number",
      "nationalIdNumber": "IT03939130989",
      "nationalIdTypes": [
        "European VAT number"
      ]
    },
    {
      "nationalIdLabel": "LEI",
      "nationalIdNumber": "815600A8B74DD2682C95",
      "nationalIdTypes": [
        "Company ID number"
      ]
    }
  ],
  "naceCore": [
    "Media & Broadcasting"
  ],
  "naceMain": [
    "J - Information and communication"
  ],
  "nacePrimary": [
    "6312"
  ],
  "naicsCore": [
    "5192"
  ],
  "naicsPrimary": [
    "519290"
  ],
  "nameInternational": "Matchplat S.R.L.",
  "nameNative": "Matchplat S.R.L.",
  "nationalCodeType": [
    "ATECO 2007"
  ],
  "nationalPrimary": [
    "631200"
  ],
  "nuts1": "ITC - Northwest",
  "nuts2": "ITC4 - Lombardia",
  "nuts3": "ITC47 - Brescia",
  "phone": "+39 0305580633",
  "postcode": "25030",
  "region": "Lombardia|Brescia",
  "sicCore": [
    "737"
  ],
  "sicPrimary": [
    "7379"
  ],
  "status": "Active",
  "typeOfRegion": "Region|Province",
  "usMetropolitanArea": "",
  "usState": "",
  "website": "www.matchplat.com"
}