# Validate a Company

Validate company data and automatically correct most typos

## Required inputs

For validation of a company, you need at least one of these required information.

### Country ID

By an international system of **<https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2>**

| Company name | Content |
| --- | --- |
| "Name of a company" | For example: Avantro s.r.o. |

### Company registration number (ID)

| State | Company ID |
| --- | --- |
| Czech Republic | IČO - Identifikační číslo osoby |
| Poland | REGON - Rejestr Gospodarki Narodowej |
| Slovakia | IČO - Identifikačné číslo organizácie |

### TAX number

| State | Company TAX number |
| --- | --- |
| Czech Republic | Is not used in the Czech Republic |
| Poland | NIP - numer identyfikacji podatkowej |
| Slovakia | DIČ - Only used for income tax |

## What can you set?

| Data scope | Content |
| --- | --- |
| Empty | The setting will be set to the default state, which in this case means 'Basic'. |
| Basic | Retrieve the company name, tax numbers (including VAT numbers), and address data from the official registry. |
| Extended | The extended data scope provides the same information as the basic version but with additional details about the company's legal form and operations. For example, it includes NACE codes, trade license information, and more. The availability of this data varies depending on the country. For information on availability, [refer to the company data scopes](https://foxentry.dev/api/company/datascopes). |
| Full | The full data scope provides the same information as both the basic and extended versions but with more detailed coverage. For example, it includes databoxes, business premises, and additional information. The availability of this data varies depending on the country. For more details about availability, [refer to the company data scopes](https://foxentry.dev/api/company/datascopes) . |

| Data source | Content |
| --- | --- |
| CZ | Companies registered in the Czech Republic |
| PL | Companies registered in Poland |
| PL | Companies registered in Slovakia |

| Results limit | Content |
| --- | --- |
| 10 | Results limit of response. You can choose the limit of results for the /search endpoints as well as the limit of suggestions for the |

| Include terminated subjects | Content |
| --- | --- |
| Yes | Include entities that have already ended their existence in the output. |
| No | Exclude entities that have already ended their existence in the output. |
| Empty | The setting will be set to the default state, which in this case means 'No'. |

| ZIP format | Content |
| --- | --- |
| Yeas | The ZIP Code in response should be formatted - 130 00 |
| No | The ZIP Code in response should not be formatted - 13000 |
| Empty | The setting will be set to the default state, which in this case means 'No'. |

| City format | Content |
| --- | --- |
| Empty | The setting will be set to the default state, which in this case means 'Basic'. |
| Minimal | Praha |
| Basic | Praha 8 |
| Extended | Praha 8 - Karlín. |

## What can you find in the response?

### Basic

```json
{
  "status": 200,
  "request": { "endpoint": "company/validate", "code": "0c8c7aa3-ce8d-4e55-9ea6-7e6ddcb218bb" },
  "response": {
    "result": {
      "isValid": null,
      "proposal": "invalidWithCorrection",
      "data": {
        "uuid": null, "country": "CZ", "name": "avantro", "registrationNumber": "04997476",
        "taxNumber": null, "vatNumber": null, "vatNumberSpecial": null, "address": null, "addressOfficial": null
      },
      "errors": [
        {
          "group": "FORMAT", "type": "CHARACTERS", "subtype": "CASE_SENSITIVITY", "severity": "warning",
          "relatedTo": ["name"], "description": "Invalid case sensitivity. Specific..."
        }
      ],
      "resultCorrected": {
        "isValid": true,
        "data": {
          "uuid": "ca3665de-ded1-47f7-9bcd-b8c3eb0c5...", "country": "CZ", "name": "AVANTRO s.r.o.",
          "registrationNumber": "04997476", "taxNumber": null, "vatNumber": "CZ04997476", "vatNumberSpecial": null,
          "address": {
            "data": {
              "country": "CZ",
              "ids": { "internal": "d2ade877-1e95-4a83-baa...", "external": "22349995" },
              "street": "Thámova",
              "number": { "part1": "137", "part1Number": "137", "part1Letter": null, "part2": "16", "part2Number": "16", "part2Letter": null, "full": "137/16" },
              "streetWithNumber": "Thámova 137/16", "city": "Praha 8", "zip": "18600", "full": "Thámova 137/16, 18600 Praha 8"
            }
          },
          "addressOfficial": {
            "data": {
              "country": "CZ", "street": "Thámova",
              "number": { "part1": null, "part1Number": null, "part1Letter": null, "part2": null, "part2Number": null, "part2Letter": null, "full": "137/16" },
              "streetWithNumber": "Thámova 137/16", "city": "Praha", "zip": "18600", "full": "Thámova 137/16, Karlín, 18600 Pra..."
            }
          },
          "errors": []
        }
      },
      "fixes": [
        { "group": "FORMAT", "type": "CHANGED", "subtype": "CASE_SENSITIVITY", "data": { "typeFrom": "name", "type": "name", "valueFrom": "avantro s.r.o.", "value": "AVANTRO s.r.o." } }
      ],
      "suggestions": [],
      "errors": []
    }
  }
}
```

### Extended

```json
{
  "status": 200,
  "request": { "endpoint": "company/validate", "code": "af6578c4-9fb3-48d7-973b-93276bb301d0" },
  "response": {
    "result": {
      "isValid": null,
      "proposal": "invalidWithCorrection",
      "data": {
        "country": "CZ", "name": "avantro", "registrationNumber": "04997476",
        "taxNumber": null, "vatNumber": null, "vatNumberSpecial": null, "address": null, "addressOfficial": null,
        "nace": [], "registrations": [], "legalForm": { "code": null, "name": null }, "legalFormSpecific": { "code": null, "name": null },
        "esa2010": { "code": null, "name": null }, "dates": { "created": null, "terminated": null }, "tradeLicences": [],
        "vat": { "status": null, "reliability": { "reliable": null, "unreliableFrom": null } },
        "bankAccounts": [], "history": [], "errors": []
      },
      "errors": [
        { "group": "FORMAT", "type": "CHARACTERS", "subtype": "CASE_SENSITIVITY", "severity": "warning", "relatedTo": ["name"], "description": "Invalid case sensitivity. Specific..." }
      ],
      "resultCorrected": {
        "isValid": true,
        "data": {
          "uuid": "ca3665de-ded1-47f7-9bcd-b8c3eb0c5...", "country": "CZ", "name": "AVANTRO s.r.o.", "registrationNumber": "04997476",
          "taxNumber": null, "vatNumber": "CZ04997476", "vatNumberSpecial": null,
          "address": {
            "data": {
              "country": "CZ",
              "ids": { "internal": "d2ade877-1e95-4a83-ba...", "external": "22349995" },
              "street": "Thámova",
              "number": { "part1": "137", "part1Number": "137", "part1Letter": null, "part2": "16", "part2Number": "16", "part2Letter": null, "full": "137/16" },
              "streetWithNumber": "Thámova 137/16", "city": "Praha 8", "zip": "18600", "full": "Thámova 137/16, 18600 Praha 8"
            }
          },
          "addressOfficial": {
            "data": {
              "country": "CZ", "street": "Thámova",
              "number": { "part1": null, "part1Number": null, "part1Letter": null, "part2": null, "part2Number": null, "part2Letter": null, "full": "137/16" },
              "streetWithNumber": "Thámova 137/16", "city": "Praha", "zip": "18600", "full": "Thámova 137/16, Karlín, 18600 Pra..."
            }
          },
          "nace": [{ "code": "74", "name": "Ostatní profesní, vědecké a technické...", "isPrimary": null }],
          "registrations": [{ "type": "vatRegister", "data": { "register": { "code": null, "name": null, "detail": null }, "registrator": { "code": "008", "name": "Územní pracoviště pro Prahu 8", "detail": null }, "reference": "C 256795" } }],
          "legalForm": { "code": "112", "name": "Společnost s ručením omezeným" },
          "legalFormSpecific": { "code": null, "name": null },
          "esa2010": { "code": "11002", "name": "Národní soukromé nefinanční podniky..." },
          "dates": { "created": "2016-04-15", "terminated": null },
          "tradeLicences": [{
            "type": "živnost volná", "name": "Výroba, obchod a služby neuvedené...",
            "valid": { "from": "2016-04-15", "fromText": null, "to": null, "toText": null },
            "interrupted": { "from": null, "to": null }, "responsiblePerson": null,
            "activitySubjects": ["Povrchové úpravy a svařování kovů..."]
          }],
          "vat": { "status": "payer", "reliability": { "reliable": true, "unreliableFrom": null } },
          "bankAccounts": [{ "number": "CZ6620100000002902049845" }],
          "history": [],
          "errors": []
        }
      },
      "fixes": [
        { "group": "FORMAT", "type": "CHANGED", "subtype": "CASE_SENSITIVITY", "data": { "typeFrom": "name", "type": "name", "valueFrom": "avantro s.r.o.", "value": "AVANTRO s.r.o." } }
      ],
      "suggestions": [], "errors": []
    }
  }
}
```

### Full

Neověřeno: tento obrázek (`validate-a-company_Full.png`, "Full" sekce) se nepodařilo přečíst — zdrojový screenshot je příliš dlouhý a drobný (400×6292 px škálováno na jednu stránku), text je pod rozlišením čitelnosti. Struktura "Full" úrovně je vidět v [Get Company Information → Full](https://foxentry.dev/no-code/make/actions/get-company-information#full) (stejná pole, stejný endpoint), na kterou tato stránka výše stejně odkazuje.
