Brazilian Company Lookup (CNPJ Registry Data)

{
  "type": "object",
  "required": [
    "cnpj"
  ],
  "properties": {
    "cnpj": {
      "type": "string",
      "description": "CNPJ number (14 digits, e.g. 11222333000181)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "cnpj": {
      "type": "string",
      "description": "Formatted with punctuation, e.g. '33.000.167/0001-01'."
    },
    "size": {
      "type": "string",
      "description": "e.g. 'DEMAIS' (large/other) or 'EMPRESA DE PEQUENO PORTE' (small business)."
    },
    "type": {
      "type": "string",
      "description": "Typically 'MATRIZ' (headquarters). A branch office would be documented by the registry as 'FILIAL' but was not observed in testing."
    },
    "status": {
      "type": "string",
      "description": "Registration status, e.g. 'ATIVA' (active) or 'INAPTA' (delinquent/inactive) -- both values occur in practice."
    },
    "address": {
      "type": "string",
      "description": "Single-line registered business address as held by the registry."
    },
    "partners": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "role": {
            "type": "string",
            "description": "e.g. '16-Presidente', '10-Diretor'."
          }
        },
        "additionalProperties": true
      },
      "description": "Officers/partners on file with the registry. Observed empty on a sole-proprietor small business and populated with 8 entries on a large corporation -- not a fixed size."
    },
    "trade_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "The company's trading/DBA name. Null for a business that has no registered trade name distinct from its legal name."
    },
    "company_name": {
      "type": "string",
      "description": "Registered legal name, e.g. 'PETROLEO BRASILEIRO S A PETROBRAS'."
    },
    "legal_nature": {
      "type": "string",
      "description": "e.g. '203-8 - Sociedade de Economia Mista'."
    },
    "opening_date": {
      "type": "string",
      "description": "DD/MM/YYYY, e.g. '28/09/1966'."
    },
    "share_capital": {
      "type": "string",
      "description": "Declared share capital as a plain numeric string, e.g. '10000.00'."
    },
    "activity_codes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "e.g. '06.00-0-01'."
          },
          "description": {
            "type": "string",
            "description": "Observed as a masked literal '********' string for a delinquent-status company rather than an omitted or null field."
          }
        },
        "additionalProperties": true
      },
      "description": "Registered economic activity (CNAE) codes, typically at least one entry."
    }
  },
  "description": "The CNPJ registry record.",
  "additionalProperties": true
}