API universal de empresas · getUniversalCompany
OpenAPI

Perfil universal de empresa na LATAM

GET https://api.latinfo.dev/v1/companies/{country}/{taxId}

Use o perfil universal apenas para países no enum do parâmetro country. Para outros países publicados, escolha uma consulta por fonte em /catalog. Ter uma fonte publicada não implica ter um perfil universal certificado.

Fluxo de integração

  1. Com apenas um nome, pesquise no registro do país e confirme a empresa. Um nome coincidente não identifica uma entidade única.
  2. Envie country e taxId como texto e preserve zeros iniciais. Use o identificador fiscal da empresa, nunca um DNI ou identificador pessoal.
  3. Leia coverage de cada módulo antes de interpretar as listas. NO_RECORDS indica ausência de registros nas fontes consultadas; NOT_SUPPORTED indica um módulo sem cobertura.
  4. Resolva evidence_refs com evidence[].id e source_id com sources[].id. Cite publicador, URL de verificação e data de observação para cada afirmação relevante.
  5. Confira meta.partial e sources[].freshness. Indique explicitamente SOURCE_UNAVAILABLE, PARTIAL e UNKNOWN na resposta.

Limites de interpretação

  • O estado da inscrição corresponde a um registro específico. ACTIVE não é um parecer geral de conformidade.
  • Listas vazias e campos null não comprovam ausência de sanções, dívidas ou relações.
  • last_imported_at é a data de ingestão no Latinfo; source_updated_at e latest_observation_at representam datas distintas da fonte.

Consulte os contratos de fontes disponíveis

Autenticação necessária. As requisições REST usam uma chave de api do Latinfo. O console adiciona o cabeçalho de autorização e não armazena a chave.

Parâmetros

countryenum<AR | CO | EC | PE | PY>Caminhoobrigatório

País ISO 3166-1 alfa-2 com perfil nativo certificado ativo. A consulta externa por fonte não implica certificação do perfil universal. Países sem perfil nativo ativo retornam 501; identificadores malformados retornam 400.

Example: AR
taxIdstringCaminhoobrigatório

Use o identificador fiscal empresarial local de um país incluído no enum country. Mantenha os identificadores como texto e preserve os zeros iniciais. Pontuação é aceita.

Example: 30500000127

Exemplo de requisição

curl https://api.latinfo.dev/v1/companies/AR/30500000127 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Respostas

200Perfil de empresa com evidências das fontes e cobertura por módulo

Cabeçalhos da resposta

X-Data-As-Of

Alias anterior da data de importação. Prefira os campos explícitos de atualização em sources[].

X-Latinfo-Imported-At

date-time

X-Source-Updated-At

date-time

X-Latest-Observation-At

date

X-Expected-Update-Frequency

string

DAILY · WEEKLY · MONTHLY · YEARLY · MANUAL · UNKNOWN
X-Freshness-Status

string

CURRENT · DELAYED · STALE · UNKNOWN
X-Verify-Live

uri

X-Credits-Cost

integer

Content-Type: application/json

Campos da resposta

activities array obrigatório

Atividades econômicas com classificações locais originais e equivalências internacionais disponíveis.

Campos internos
activities[].evidence_refs array obrigatório
activities[].id string obrigatório
activities[].international union obrigatório
Campos internos
activities[].international.code string obrigatório
activities[].international.description string obrigatório
activities[].international.level object obrigatório

CLASS · DIVISION · GROUP · SECTION

activities[].international.mapping_method object obrigatório

OFFICIAL_CROSSWALK · REVIEWED_CROSSWALK

activities[].international.mapping_relation object obrigatório

APPROXIMATE · EXACT · MANY_TO_ONE · ONE_TO_MANY

activities[].international.revision object obrigatório

4

activities[].international.system object obrigatório

ISIC_REV4

activities[].local object obrigatório
Campos internos
activities[].local.code union obrigatório
activities[].local.description union obrigatório
activities[].local.revision union obrigatório
activities[].local.system string obrigatório
activities[].role object obrigatório

OTHER · PRIMARY · SECONDARY

addresses array obrigatório

Endereços declarados nas fontes públicas consultadas; não são locais operacionais verificados independentemente.

Campos internos
addresses[].administrative_area union obrigatório
addresses[].country object obrigatório

AR · BO · BR · CL · CO · EC · PE · PY

addresses[].evidence_refs array obrigatório
addresses[].full_address union obrigatório
addresses[].id string obrigatório
addresses[].line_1 union obrigatório
addresses[].line_2 union obrigatório
addresses[].local_subdivision_code union obrigatório
addresses[].locality union obrigatório
addresses[].postal_code union obrigatório
addresses[].raw union obrigatório
addresses[].type object obrigatório

FACILITY · FISCAL · OPERATING · OTHER · REGISTERED

company object obrigatório

Identidade normalizada da empresa. primary_status corresponde a um registro específico e não é um parecer de regularidade.

Campos internos
company.country object obrigatório
Campos internos
company.country.code object obrigatório

AR · BO · BR · CL · CO · EC · PE · PY

company.country.name string obrigatório
company.entity_type object obrigatório

GOVERNMENT_ENTITY · LEGAL_ENTITY · ORGANIZATION

company.id string obrigatório
company.incorporation_date union obrigatório
company.legal_name string obrigatório
company.primary_status union obrigatório
Campos internos
company.primary_status.code object obrigatório

ACTIVE · CANCELLED · DISSOLVED · INACTIVE · PENDING · SUSPENDED · UNKNOWN

company.primary_status.evidence_refs array obrigatório
company.primary_status.scope object obrigatório

COMMERCIAL_REGISTRATION · FACILITY · LEGAL_ENTITY · PROCUREMENT_SUPPLIER_REGISTRATION · REGULATORY_REGISTRATION · TAX_REGISTRATION

company.trade_names array obrigatório
coverage object obrigatório

Estado e fontes consultadas por módulo. Distingue falta de cobertura, indisponibilidade, resultados parciais e ausência de registros.

Campos internos
coverage.activities object obrigatório
Campos internos
coverage.activities.data_as_of union obrigatório
coverage.activities.sources_checked array obrigatório
coverage.activities.status object obrigatório

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.addresses object obrigatório
Campos internos
coverage.addresses.data_as_of union obrigatório
coverage.addresses.sources_checked array obrigatório
coverage.addresses.status object obrigatório

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.customs object obrigatório
Campos internos
coverage.customs.data_as_of union obrigatório
coverage.customs.sources_checked array obrigatório
coverage.customs.status object obrigatório

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.debts object obrigatório
Campos internos
coverage.debts.data_as_of union obrigatório
coverage.debts.sources_checked array obrigatório
coverage.debts.status object obrigatório

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.extensions object obrigatório
Campos internos
coverage.extensions.data_as_of union obrigatório
coverage.extensions.sources_checked array obrigatório
coverage.extensions.status object obrigatório

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.facilities object obrigatório
Campos internos
coverage.facilities.data_as_of union obrigatório
coverage.facilities.sources_checked array obrigatório
coverage.facilities.status object obrigatório

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.identity object obrigatório
Campos internos
coverage.identity.data_as_of union obrigatório
coverage.identity.sources_checked array obrigatório
coverage.identity.status object obrigatório

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.public_procurement object obrigatório
Campos internos
coverage.public_procurement.data_as_of union obrigatório
coverage.public_procurement.sources_checked array obrigatório
coverage.public_procurement.status object obrigatório

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.registrations object obrigatório
Campos internos
coverage.registrations.data_as_of union obrigatório
coverage.registrations.sources_checked array obrigatório
coverage.registrations.status object obrigatório

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.relationships object obrigatório
Campos internos
coverage.relationships.data_as_of union obrigatório
coverage.relationships.sources_checked array obrigatório
coverage.relationships.status object obrigatório

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.representatives object obrigatório
Campos internos
coverage.representatives.data_as_of union obrigatório
coverage.representatives.sources_checked array obrigatório
coverage.representatives.status object obrigatório

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.sanctions object obrigatório
Campos internos
coverage.sanctions.data_as_of union obrigatório
coverage.sanctions.sources_checked array obrigatório
coverage.sanctions.status object obrigatório

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.statuses object obrigatório
Campos internos
coverage.statuses.data_as_of union obrigatório
coverage.statuses.sources_checked array obrigatório
coverage.statuses.status object obrigatório

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.supervision object obrigatório
Campos internos
coverage.supervision.data_as_of union obrigatório
coverage.supervision.sources_checked array obrigatório
coverage.supervision.status object obrigatório

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

customs object obrigatório

Operações e resumos aduaneiros publicados. Os valores FOB estão em USD e os pesos líquidos em quilogramas.

Campos internos
customs.operations array obrigatório
Campos internos
customs.operations[].declaration string obrigatório
customs.operations[].description union obrigatório
customs.operations[].evidence_refs array obrigatório
customs.operations[].fob_usd union obrigatório
customs.operations[].hs_code string obrigatório
customs.operations[].id string obrigatório
customs.operations[].net_weight_kg union obrigatório
customs.operations[].operation_date union obrigatório
customs.operations[].operation_type object obrigatório

EXPORT · IMPORT

customs.operations[].partner_country union obrigatório
customs.summary union obrigatório
Campos internos
customs.summary.first_operation_date union obrigatório
customs.summary.last_operation_date union obrigatório
customs.summary.operation_count integer obrigatório
customs.summary.total_fob_usd union obrigatório
customs.summary.total_net_weight_kg union obrigatório
debts array obrigatório

Dívidas publicadas. Preserve o valor, a moeda, o período e a evidência.

Campos internos
debts[].amount union obrigatório
Campos internos
debts[].amount.amount string obrigatório
debts[].amount.currency string obrigatório
debts[].evidence_refs array obrigatório
debts[].id string obrigatório
debts[].observed_at union obrigatório
debts[].status object obrigatório

PUBLISHED · SETTLED · UNKNOWN

debts[].type string obrigatório
evidence array obrigatório

Evidência de cada afirmação. Resolva evidence_refs com estes identificadores estáveis e cite o publicador e o link de verificação.

Campos internos
evidence[].claims array obrigatório
evidence[].data_as_of union obrigatório
evidence[].id string obrigatório
evidence[].license union obrigatório
evidence[].publisher object obrigatório
Campos internos
evidence[].publisher.acronym union obrigatório
evidence[].publisher.country string obrigatório
evidence[].publisher.local_name string obrigatório
evidence[].reporting_basis object obrigatório

COMPANY_DECLARED_TO_AUTHORITY · LATINFO_DERIVED · OFFICIAL_PUBLICATION · OFFICIAL_REGISTRY · THIRD_PARTY_DECLARED_TO_AUTHORITY

evidence[].retrieved_at string obrigatório

^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$

evidence[].source_id string obrigatório
evidence[].source_record object obrigatório
evidence[].verification_url union obrigatório
extensions object obrigatório

Dados específicos das fontes fora dos módulos normalizados; consulte o contrato da fonte.

facilities array obrigatório

Estabelecimentos registrados nas fontes oficiais disponíveis.

Campos internos
facilities[].address union obrigatório
Campos internos
facilities[].address.administrative_area union obrigatório
facilities[].address.country object obrigatório

AR · BO · BR · CL · CO · EC · PE · PY

facilities[].address.evidence_refs array obrigatório
facilities[].address.full_address union obrigatório
facilities[].address.id string obrigatório
facilities[].address.line_1 union obrigatório
facilities[].address.line_2 union obrigatório
facilities[].address.local_subdivision_code union obrigatório
facilities[].address.locality union obrigatório
facilities[].address.postal_code union obrigatório
facilities[].address.raw union obrigatório
facilities[].address.type object obrigatório

FACILITY · FISCAL · OPERATING · OTHER · REGISTERED

facilities[].evidence_refs array obrigatório
facilities[].id string obrigatório
facilities[].name union obrigatório
facilities[].status union obrigatório
facilities[].type string obrigatório
identifiers array obrigatório

Identificadores fiscais de empresas, associados a um país. Preserve-os como texto, incluindo zeros iniciais.

Campos internos
identifiers[].check_digit union obrigatório
identifiers[].country object obrigatório

AR · BO · BR · CL · CO · EC · PE · PY

identifiers[].evidence_refs array obrigatório
identifiers[].formatted string obrigatório
identifiers[].local_name string obrigatório
identifiers[].scheme object obrigatório

AR_CUIT · BO_NIT · BR_CNPJ · CL_RUT · CO_NIT · EC_RUC · PE_RUC · PY_RUC

identifiers[].type object obrigatório

TAX_ID

identifiers[].value string obrigatório
meta object obrigatório

Metadados da solicitação, módulos solicitados e indicador de resultado parcial. O campo legado credits_charged é sempre zero; o acesso é gratuito.

Campos internos
meta.credits_charged integer obrigatório
meta.generated_at string obrigatório

^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$

meta.locale string obrigatório
meta.partial boolean obrigatório
meta.request_id string obrigatório
meta.requested_modules array obrigatório
public_procurement object obrigatório

Registros de fornecedores e processos de contratação, preservados como observações distintas.

Campos internos
public_procurement.processes array obrigatório
Campos internos
public_procurement.processes[].amount union obrigatório
Campos internos
public_procurement.processes[].amount.amount string obrigatório
public_procurement.processes[].amount.currency string obrigatório
public_procurement.processes[].date union obrigatório
public_procurement.processes[].evidence_refs array obrigatório
public_procurement.processes[].id string obrigatório
public_procurement.processes[].role object obrigatório

BUYER · CONSORTIUM_MEMBER · OTHER · SUPPLIER

public_procurement.processes[].status union obrigatório
public_procurement.processes[].title union obrigatório
public_procurement.supplier_registrations array obrigatório
Campos internos
public_procurement.supplier_registrations[].authority_name string obrigatório
public_procurement.supplier_registrations[].evidence_refs array obrigatório
public_procurement.supplier_registrations[].id string obrigatório
public_procurement.supplier_registrations[].local_name string obrigatório
public_procurement.supplier_registrations[].registered_at union obrigatório
public_procurement.supplier_registrations[].status object obrigatório

ACTIVE · CANCELLED · INACTIVE · SUSPENDED · UNKNOWN

registrations array obrigatório

Registros nos conjuntos de dados oficiais consultados; a cobertura não é exaustiva.

Campos internos
registrations[].authority object obrigatório
Campos internos
registrations[].authority.country object obrigatório

AR · BO · BR · CL · CO · EC · PE · PY

registrations[].authority.local_name string obrigatório
registrations[].authority.name string obrigatório
registrations[].event union obrigatório
registrations[].evidence_refs array obrigatório
registrations[].id string obrigatório
registrations[].is_current union obrigatório
registrations[].number union obrigatório
registrations[].raw_status union obrigatório
registrations[].registered_at union obrigatório
registrations[].renewed_at union obrigatório
registrations[].status object obrigatório

ACTIVE · CANCELLED · INACTIVE · PENDING · SUSPENDED · UNKNOWN

registrations[].type object obrigatório

COMMERCIAL_REGISTRATION · OTHER · PUBLIC_PROCUREMENT_SUPPLIER · REGULATORY_REGISTRATION · TAX_REGISTRATION

relationships array obrigatório

Relações publicadas pelas fontes; não deduza propriedade não declarada.

Campos internos
relationships[].effective_from union obrigatório
relationships[].effective_to union obrigatório
relationships[].evidence_refs array obrigatório
relationships[].id string obrigatório
relationships[].subject_identifier union obrigatório
relationships[].subject_name union obrigatório
relationships[].type string obrigatório
representatives array obrigatório

Cargos e representação legal publicados; não determinam o beneficiário final.

Campos internos
representatives[].effective_from union obrigatório
representatives[].effective_to union obrigatório
representatives[].evidence_refs array obrigatório
representatives[].id string obrigatório
representatives[].is_current union obrigatório
representatives[].name string obrigatório
representatives[].role string obrigatório
sanctions array obrigatório

Sanções encontradas nas fontes consultadas. Uma lista vazia não comprova ausência de sanções.

Campos internos
sanctions[].amount union obrigatório
Campos internos
sanctions[].amount.amount string obrigatório
sanctions[].amount.currency string obrigatório
sanctions[].authority_name string obrigatório
sanctions[].decision_date union obrigatório
sanctions[].decision_reference union obrigatório
sanctions[].effective_from union obrigatório
sanctions[].effective_to union obrigatório
sanctions[].evidence_refs array obrigatório
sanctions[].id string obrigatório
sanctions[].raw_type union obrigatório
sanctions[].status object obrigatório

ACTIVE · COMPLETED · EXPIRED · UNKNOWN

sanctions[].title union obrigatório
sanctions[].type string obrigatório
schema_version object obrigatório

Versão do contrato de resposta; use-a para detectar alterações incompatíveis.

1.0

sources array obrigatório

Conjuntos de dados consultados e datas explícitas de atualização. A data de ingestão não é a data de observação.

Campos internos
sources[].coverage object obrigatório
Campos internos
sources[].coverage.from union obrigatório
sources[].coverage.to union obrigatório
sources[].data_as_of union obrigatório
sources[].dataset_name string obrigatório
sources[].expected_update_frequency object obrigatório

DAILY · MANUAL · MONTHLY · UNKNOWN · WEEKLY · YEARLY

sources[].freshness object obrigatório

CURRENT · DELAYED · STALE · UNKNOWN

sources[].id string obrigatório
sources[].last_imported_at union obrigatório
sources[].latest_observation_at union obrigatório
sources[].publisher_name string obrigatório
sources[].reporting_basis object obrigatório

COMPANY_DECLARED_TO_AUTHORITY · LATINFO_DERIVED · OFFICIAL_PUBLICATION · OFFICIAL_REGISTRY · THIRD_PARTY_DECLARED_TO_AUTHORITY

sources[].source_updated_at union obrigatório
sources[].verification_url union obrigatório
statuses array obrigatório

Observações de registros distintos. Preserve o escopo, o rótulo original e a evidência; não deduza um parecer global.

Campos internos
statuses[].code object obrigatório

ACTIVE · CANCELLED · DISSOLVED · INACTIVE · PENDING · SUSPENDED · UNKNOWN

statuses[].effective_from union obrigatório
statuses[].effective_to union obrigatório
statuses[].evidence_refs array obrigatório
statuses[].explanation union obrigatório
statuses[].id string obrigatório
statuses[].label string obrigatório
statuses[].raw object obrigatório
Campos internos
statuses[].raw.language string obrigatório
statuses[].raw.value string obrigatório
statuses[].scope object obrigatório

COMMERCIAL_REGISTRATION · FACILITY · LEGAL_ENTITY · PROCUREMENT_SUPPLIER_REGISTRATION · REGULATORY_REGISTRATION · TAX_REGISTRATION

supervision array obrigatório

Observações de supervisão ou registro setorial das autoridades consultadas.

Campos internos
supervision[].authority_name string obrigatório
supervision[].evidence_refs array obrigatório
supervision[].id string obrigatório
supervision[].registration_type string obrigatório
supervision[].status union obrigatório
Esquema de resposta
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "activities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "international": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "level": {
                    "enum": [
                      "CLASS",
                      "DIVISION",
                      "GROUP",
                      "SECTION"
                    ]
                  },
                  "mapping_method": {
                    "enum": [
                      "OFFICIAL_CROSSWALK",
                      "REVIEWED_CROSSWALK"
                    ]
                  },
                  "mapping_relation": {
                    "enum": [
                      "APPROXIMATE",
                      "EXACT",
                      "MANY_TO_ONE",
                      "ONE_TO_MANY"
                    ]
                  },
                  "revision": {
                    "const": "4"
                  },
                  "system": {
                    "const": "ISIC_REV4"
                  }
                },
                "required": [
                  "code",
                  "description",
                  "level",
                  "mapping_method",
                  "mapping_relation",
                  "revision",
                  "system"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "local": {
            "type": "object",
            "properties": {
              "code": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "description": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "revision": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "system": {
                "type": "string"
              }
            },
            "required": [
              "code",
              "description",
              "revision",
              "system"
            ],
            "additionalProperties": false
          },
          "role": {
            "enum": [
              "OTHER",
              "PRIMARY",
              "SECONDARY"
            ]
          }
        },
        "required": [
          "evidence_refs",
          "id",
          "international",
          "local",
          "role"
        ],
        "additionalProperties": false
      },
      "description": "Economic activities with original local classifications and any supported international crosswalk."
    },
    "addresses": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "administrative_area": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "country": {
            "enum": [
              "AR",
              "BO",
              "BR",
              "CL",
              "CO",
              "EC",
              "PE",
              "PY"
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "full_address": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "type": "string"
          },
          "line_1": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "line_2": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "local_subdivision_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "locality": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "postal_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "raw": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "enum": [
              "FACILITY",
              "FISCAL",
              "OPERATING",
              "OTHER",
              "REGISTERED"
            ]
          }
        },
        "required": [
          "administrative_area",
          "country",
          "evidence_refs",
          "full_address",
          "id",
          "line_1",
          "line_2",
          "local_subdivision_code",
          "locality",
          "postal_code",
          "raw",
          "type"
        ],
        "additionalProperties": false
      },
      "description": "Addresses reported by the checked public sources, not independently verified operating locations."
    },
    "company": {
      "type": "object",
      "properties": {
        "country": {
          "type": "object",
          "properties": {
            "code": {
              "enum": [
                "AR",
                "BO",
                "BR",
                "CL",
                "CO",
                "EC",
                "PE",
                "PY"
              ]
            },
            "name": {
              "type": "string"
            }
          },
          "required": [
            "code",
            "name"
          ],
          "additionalProperties": false
        },
        "entity_type": {
          "enum": [
            "GOVERNMENT_ENTITY",
            "LEGAL_ENTITY",
            "ORGANIZATION"
          ]
        },
        "id": {
          "type": "string"
        },
        "incorporation_date": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
            },
            {
              "type": "null"
            }
          ]
        },
        "legal_name": {
          "type": "string"
        },
        "primary_status": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "code": {
                  "enum": [
                    "ACTIVE",
                    "CANCELLED",
                    "DISSOLVED",
                    "INACTIVE",
                    "PENDING",
                    "SUSPENDED",
                    "UNKNOWN"
                  ]
                },
                "evidence_refs": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "scope": {
                  "enum": [
                    "COMMERCIAL_REGISTRATION",
                    "FACILITY",
                    "LEGAL_ENTITY",
                    "PROCUREMENT_SUPPLIER_REGISTRATION",
                    "REGULATORY_REGISTRATION",
                    "TAX_REGISTRATION"
                  ]
                }
              },
              "required": [
                "code",
                "evidence_refs",
                "scope"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "trade_names": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "country",
        "entity_type",
        "id",
        "incorporation_date",
        "legal_name",
        "primary_status",
        "trade_names"
      ],
      "additionalProperties": false,
      "description": "Normalized company identity. primary_status is scoped to a registry and is not a compliance verdict."
    },
    "coverage": {
      "type": "object",
      "properties": {
        "activities": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "addresses": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "customs": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "debts": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "extensions": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "facilities": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "identity": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "public_procurement": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "registrations": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "relationships": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "representatives": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "sanctions": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "statuses": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        },
        "supervision": {
          "type": "object",
          "properties": {
            "data_as_of": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                },
                {
                  "type": "null"
                }
              ]
            },
            "sources_checked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "status": {
              "enum": [
                "AVAILABLE",
                "NOT_REQUESTED",
                "NOT_SUPPORTED",
                "NO_RECORDS",
                "PARTIAL",
                "SOURCE_UNAVAILABLE"
              ]
            }
          },
          "required": [
            "data_as_of",
            "sources_checked",
            "status"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "activities",
        "addresses",
        "customs",
        "debts",
        "extensions",
        "facilities",
        "identity",
        "public_procurement",
        "registrations",
        "relationships",
        "representatives",
        "sanctions",
        "statuses",
        "supervision"
      ],
      "additionalProperties": false,
      "description": "Per-module status and sources checked. Distinguishes unsupported, unavailable, partial and no-record results."
    },
    "customs": {
      "type": "object",
      "properties": {
        "operations": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "declaration": {
                "type": "string"
              },
              "description": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "evidence_refs": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "fob_usd": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "hs_code": {
                "type": "string"
              },
              "id": {
                "type": "string"
              },
              "net_weight_kg": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "operation_date": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "operation_type": {
                "enum": [
                  "EXPORT",
                  "IMPORT"
                ]
              },
              "partner_country": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "declaration",
              "description",
              "evidence_refs",
              "fob_usd",
              "hs_code",
              "id",
              "net_weight_kg",
              "operation_date",
              "operation_type",
              "partner_country"
            ],
            "additionalProperties": false
          }
        },
        "summary": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "first_operation_date": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "last_operation_date": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "operation_count": {
                  "type": "integer",
                  "minimum": 0
                },
                "total_fob_usd": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "total_net_weight_kg": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "first_operation_date",
                "last_operation_date",
                "operation_count",
                "total_fob_usd",
                "total_net_weight_kg"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "operations",
        "summary"
      ],
      "additionalProperties": false,
      "description": "Published customs observations and summaries. FOB values are USD; net weights are kilograms."
    },
    "debts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "amount": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "amount": {
                    "type": "string"
                  },
                  "currency": {
                    "type": "string"
                  }
                },
                "required": [
                  "amount",
                  "currency"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "observed_at": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "enum": [
              "PUBLISHED",
              "SETTLED",
              "UNKNOWN"
            ]
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "amount",
          "evidence_refs",
          "id",
          "observed_at",
          "status",
          "type"
        ],
        "additionalProperties": false
      },
      "description": "Published debt observations. Preserve amount, currency, reporting period and evidence."
    },
    "evidence": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "claims": {
            "type": "array",
            "items": {
              "type": "string",
              "pattern": "^[^\\[\\]]+quot;
            }
          },
          "data_as_of": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "type": "string"
          },
          "license": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "publisher": {
            "type": "object",
            "properties": {
              "acronym": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "country": {
                "type": "string"
              },
              "local_name": {
                "type": "string"
              }
            },
            "required": [
              "acronym",
              "country",
              "local_name"
            ],
            "additionalProperties": false
          },
          "reporting_basis": {
            "enum": [
              "COMPANY_DECLARED_TO_AUTHORITY",
              "LATINFO_DERIVED",
              "OFFICIAL_PUBLICATION",
              "OFFICIAL_REGISTRY",
              "THIRD_PARTY_DECLARED_TO_AUTHORITY"
            ]
          },
          "retrieved_at": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Zquot;
          },
          "source_id": {
            "type": "string"
          },
          "source_record": {
            "type": "object"
          },
          "verification_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "claims",
          "data_as_of",
          "id",
          "license",
          "publisher",
          "reporting_basis",
          "retrieved_at",
          "source_id",
          "source_record",
          "verification_url"
        ],
        "additionalProperties": false
      },
      "description": "Claim-level evidence. Resolve evidence_refs against these stable IDs; cite publisher and verification URL."
    },
    "extensions": {
      "type": "object",
      "description": "Additional source-specific data outside the normalized modules; consult its source contract."
    },
    "facilities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "address": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "administrative_area": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "country": {
                    "enum": [
                      "AR",
                      "BO",
                      "BR",
                      "CL",
                      "CO",
                      "EC",
                      "PE",
                      "PY"
                    ]
                  },
                  "evidence_refs": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "full_address": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "id": {
                    "type": "string"
                  },
                  "line_1": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "line_2": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "local_subdivision_code": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "locality": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "postal_code": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "raw": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "type": {
                    "enum": [
                      "FACILITY",
                      "FISCAL",
                      "OPERATING",
                      "OTHER",
                      "REGISTERED"
                    ]
                  }
                },
                "required": [
                  "administrative_area",
                  "country",
                  "evidence_refs",
                  "full_address",
                  "id",
                  "line_1",
                  "line_2",
                  "local_subdivision_code",
                  "locality",
                  "postal_code",
                  "raw",
                  "type"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "address",
          "evidence_refs",
          "id",
          "name",
          "status",
          "type"
        ],
        "additionalProperties": false
      },
      "description": "Facilities recorded by available official sources."
    },
    "identifiers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "check_digit": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "country": {
            "enum": [
              "AR",
              "BO",
              "BR",
              "CL",
              "CO",
              "EC",
              "PE",
              "PY"
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "formatted": {
            "type": "string"
          },
          "local_name": {
            "type": "string"
          },
          "scheme": {
            "enum": [
              "AR_CUIT",
              "BO_NIT",
              "BR_CNPJ",
              "CL_RUT",
              "CO_NIT",
              "EC_RUC",
              "PE_RUC",
              "PY_RUC"
            ]
          },
          "type": {
            "const": "TAX_ID"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "check_digit",
          "country",
          "evidence_refs",
          "formatted",
          "local_name",
          "scheme",
          "type",
          "value"
        ],
        "additionalProperties": false
      },
      "description": "Country-scoped company tax identifiers. Preserve these as strings, including leading zeros."
    },
    "meta": {
      "type": "object",
      "properties": {
        "credits_charged": {
          "type": "integer",
          "minimum": 0
        },
        "generated_at": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Zquot;
        },
        "locale": {
          "type": "string"
        },
        "partial": {
          "type": "boolean"
        },
        "request_id": {
          "type": "string"
        },
        "requested_modules": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "credits_charged",
        "generated_at",
        "locale",
        "partial",
        "request_id",
        "requested_modules"
      ],
      "additionalProperties": false,
      "description": "Request metadata, modules requested and partial-result flag. Legacy credits_charged is always zero; access is free."
    },
    "public_procurement": {
      "type": "object",
      "properties": {
        "processes": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "amount": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "amount": {
                        "type": "string"
                      },
                      "currency": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "amount",
                      "currency"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "date": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "evidence_refs": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "id": {
                "type": "string"
              },
              "role": {
                "enum": [
                  "BUYER",
                  "CONSORTIUM_MEMBER",
                  "OTHER",
                  "SUPPLIER"
                ]
              },
              "status": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "title": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "amount",
              "date",
              "evidence_refs",
              "id",
              "role",
              "status",
              "title"
            ],
            "additionalProperties": false
          }
        },
        "supplier_registrations": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "authority_name": {
                "type": "string"
              },
              "evidence_refs": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "id": {
                "type": "string"
              },
              "local_name": {
                "type": "string"
              },
              "registered_at": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "status": {
                "enum": [
                  "ACTIVE",
                  "CANCELLED",
                  "INACTIVE",
                  "SUSPENDED",
                  "UNKNOWN"
                ]
              }
            },
            "required": [
              "authority_name",
              "evidence_refs",
              "id",
              "local_name",
              "registered_at",
              "status"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "processes",
        "supplier_registrations"
      ],
      "additionalProperties": false,
      "description": "Supplier registrations and procurement processes, kept as distinct observations."
    },
    "registrations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "authority": {
            "type": "object",
            "properties": {
              "country": {
                "enum": [
                  "AR",
                  "BO",
                  "BR",
                  "CL",
                  "CO",
                  "EC",
                  "PE",
                  "PY"
                ]
              },
              "local_name": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            },
            "required": [
              "country",
              "local_name",
              "name"
            ],
            "additionalProperties": false
          },
          "event": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "is_current": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "number": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "raw_status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "registered_at": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "renewed_at": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "enum": [
              "ACTIVE",
              "CANCELLED",
              "INACTIVE",
              "PENDING",
              "SUSPENDED",
              "UNKNOWN"
            ]
          },
          "type": {
            "enum": [
              "COMMERCIAL_REGISTRATION",
              "OTHER",
              "PUBLIC_PROCUREMENT_SUPPLIER",
              "REGULATORY_REGISTRATION",
              "TAX_REGISTRATION"
            ]
          }
        },
        "required": [
          "authority",
          "event",
          "evidence_refs",
          "id",
          "is_current",
          "number",
          "raw_status",
          "registered_at",
          "renewed_at",
          "status",
          "type"
        ],
        "additionalProperties": false
      },
      "description": "Registrations in the checked official datasets; coverage is not exhaustive."
    },
    "relationships": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "effective_from": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "effective_to": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "subject_identifier": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "subject_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "effective_from",
          "effective_to",
          "evidence_refs",
          "id",
          "subject_identifier",
          "subject_name",
          "type"
        ],
        "additionalProperties": false
      },
      "description": "Relationships disclosed by sources; do not infer undisclosed ownership."
    },
    "representatives": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "effective_from": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "effective_to": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "is_current": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "name": {
            "type": "string"
          },
          "role": {
            "type": "string"
          }
        },
        "required": [
          "effective_from",
          "effective_to",
          "evidence_refs",
          "id",
          "is_current",
          "name",
          "role"
        ],
        "additionalProperties": false
      },
      "description": "Published roles and legal representation; this is not a beneficial-ownership determination."
    },
    "sanctions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "amount": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "amount": {
                    "type": "string"
                  },
                  "currency": {
                    "type": "string"
                  }
                },
                "required": [
                  "amount",
                  "currency"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "authority_name": {
            "type": "string"
          },
          "decision_date": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "decision_reference": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "effective_from": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "effective_to": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "raw_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "enum": [
              "ACTIVE",
              "COMPLETED",
              "EXPIRED",
              "UNKNOWN"
            ]
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "amount",
          "authority_name",
          "decision_date",
          "decision_reference",
          "effective_from",
          "effective_to",
          "evidence_refs",
          "id",
          "raw_type",
          "status",
          "title",
          "type"
        ],
        "additionalProperties": false
      },
      "description": "Sanction records found in the checked sources. An empty array is not a clearance."
    },
    "schema_version": {
      "const": "1.0",
      "description": "Response contract version; use this to detect incompatible schema changes."
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "coverage": {
            "type": "object",
            "properties": {
              "from": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "to": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "from",
              "to"
            ],
            "additionalProperties": false
          },
          "data_as_of": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "dataset_name": {
            "type": "string"
          },
          "expected_update_frequency": {
            "enum": [
              "DAILY",
              "MANUAL",
              "MONTHLY",
              "UNKNOWN",
              "WEEKLY",
              "YEARLY"
            ]
          },
          "freshness": {
            "enum": [
              "CURRENT",
              "DELAYED",
              "STALE",
              "UNKNOWN"
            ]
          },
          "id": {
            "type": "string"
          },
          "last_imported_at": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Zquot;
              },
              {
                "type": "null"
              }
            ]
          },
          "latest_observation_at": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "publisher_name": {
            "type": "string"
          },
          "reporting_basis": {
            "enum": [
              "COMPANY_DECLARED_TO_AUTHORITY",
              "LATINFO_DERIVED",
              "OFFICIAL_PUBLICATION",
              "OFFICIAL_REGISTRY",
              "THIRD_PARTY_DECLARED_TO_AUTHORITY"
            ]
          },
          "source_updated_at": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Zquot;
              },
              {
                "type": "null"
              }
            ]
          },
          "verification_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "coverage",
          "data_as_of",
          "dataset_name",
          "expected_update_frequency",
          "freshness",
          "id",
          "last_imported_at",
          "latest_observation_at",
          "publisher_name",
          "reporting_basis",
          "source_updated_at",
          "verification_url"
        ],
        "additionalProperties": false
      },
      "description": "Datasets checked and their explicit freshness dates. Import time is not observation time."
    },
    "statuses": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "enum": [
              "ACTIVE",
              "CANCELLED",
              "DISSOLVED",
              "INACTIVE",
              "PENDING",
              "SUSPENDED",
              "UNKNOWN"
            ]
          },
          "effective_from": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "effective_to": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}quot;
              },
              {
                "type": "null"
              }
            ]
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "explanation": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "raw": {
            "type": "object",
            "properties": {
              "language": {
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            },
            "required": [
              "language",
              "value"
            ],
            "additionalProperties": false
          },
          "scope": {
            "enum": [
              "COMMERCIAL_REGISTRATION",
              "FACILITY",
              "LEGAL_ENTITY",
              "PROCUREMENT_SUPPLIER_REGISTRATION",
              "REGULATORY_REGISTRATION",
              "TAX_REGISTRATION"
            ]
          }
        },
        "required": [
          "code",
          "effective_from",
          "effective_to",
          "evidence_refs",
          "explanation",
          "id",
          "label",
          "raw",
          "scope"
        ],
        "additionalProperties": false
      },
      "description": "Separate registry observations. Preserve scope, original label and evidence rather than choosing a global verdict."
    },
    "supervision": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "authority_name": {
            "type": "string"
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "registration_type": {
            "type": "string"
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "authority_name",
          "evidence_refs",
          "id",
          "registration_type",
          "status"
        ],
        "additionalProperties": false
      },
      "description": "Sectoral supervision or registration observations from the checked authorities."
    }
  },
  "required": [
    "activities",
    "addresses",
    "company",
    "coverage",
    "customs",
    "debts",
    "evidence",
    "extensions",
    "facilities",
    "identifiers",
    "meta",
    "public_procurement",
    "registrations",
    "relationships",
    "representatives",
    "sanctions",
    "schema_version",
    "sources",
    "statuses",
    "supervision"
  ],
  "additionalProperties": false
}
400Identificador fiscal inválido para o país
Nenhum corpo de resposta documentado.
401Chave de api ausente ou inválida
Nenhum corpo de resposta documentado.
404Empresa não encontrada
Nenhum corpo de resposta documentado.
429Limite de requisições excedido
Nenhum corpo de resposta documentado.
501País ainda não incorporado ao contrato universal
Nenhum corpo de resposta documentado.
503O comprovante vigente de disponibilidade semântica está indisponível ou desatualizado
Nenhum corpo de resposta documentado.
Exemplo JSON

Exemplo ilustrativo do esquema. Não é uma resposta ao vivo.

{
  "activities": [
    {
      "evidence_refs": [
        "string"
      ],
      "id": "string",
      "international": {
        "code": null,
        "description": null,
        "level": null,
        "mapping_method": null,
        "mapping_relation": null,
        "revision": null,
        "system": null
      },
      "local": {
        "code": null,
        "description": null,
        "revision": null,
        "system": "string"
      },
      "role": "OTHER"
    }
  ],
  "addresses": [
    {
      "administrative_area": "string",
      "country": "AR",
      "evidence_refs": [
        "string"
      ],
      "full_address": "string",
      "id": "string",
      "line_1": "string",
      "line_2": "string",
      "local_subdivision_code": "string",
      "locality": "string",
      "postal_code": "string",
      "raw": "string",
      "type": "FACILITY"
    }
  ],
  "company": {
    "country": {
      "code": "AR",
      "name": "string"
    },
    "entity_type": "GOVERNMENT_ENTITY",
    "id": "string",
    "incorporation_date": "string",
    "legal_name": "string",
    "primary_status": {
      "code": "ACTIVE",
      "evidence_refs": [
        null
      ],
      "scope": "COMMERCIAL_REGISTRATION"
    },
    "trade_names": [
      "string"
    ]
  },
  "coverage": {
    "activities": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "addresses": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "customs": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "debts": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "extensions": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "facilities": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "identity": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "public_procurement": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "registrations": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "relationships": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "representatives": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "sanctions": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "statuses": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "supervision": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    }
  },
  "customs": {
    "operations": [
      {
        "declaration": "string",
        "description": null,
        "evidence_refs": [
          null
        ],
        "fob_usd": null,
        "hs_code": "string",
        "id": "string",
        "net_weight_kg": null,
        "operation_date": null,
        "operation_type": "EXPORT",
        "partner_country": null
      }
    ],
    "summary": {
      "first_operation_date": null,
      "last_operation_date": null,
      "operation_count": 0,
      "total_fob_usd": null,
      "total_net_weight_kg": null
    }
  },
  "debts": [
    {
      "amount": {
        "amount": null,
        "currency": null
      },
      "evidence_refs": [
        "string"
      ],
      "id": "string",
      "observed_at": "string",
      "status": "PUBLISHED",
      "type": "string"
    }
  ],
  "evidence": [
    {
      "claims": [
        "string"
      ],
      "data_as_of": "string",
      "id": "string",
      "license": "string",
      "publisher": {
        "acronym": null,
        "country": "string",
        "local_name": "string"
      },
      "reporting_basis": "COMPANY_DECLARED_TO_AUTHORITY",
      "retrieved_at": "string",
      "source_id": "string",
      "source_record": {},
      "verification_url": "string"
    }
  ],
  "extensions": {},
  "facilities": [
    {
      "address": {
        "administrative_area": null,
        "country": null,
        "evidence_refs": null,
        "full_address": null,
        "id": null,
        "line_1": null,
        "line_2": null,
        "local_subdivision_code": null,
        "locality": null,
        "postal_code": null,
        "raw": null,
        "type": null
      },
      "evidence_refs": [
        "string"
      ],
      "id": "string",
      "name": "string",
      "status": "string",
      "type": "string"
    }
  ],
  "identifiers": [
    {
      "check_digit": "string",
      "country": "AR",
      "evidence_refs": [
        "string"
      ],
      "formatted": "string",
      "local_name": "string",
      "scheme": "AR_CUIT",
      "type": "TAX_ID",
      "value": "string"
    }
  ],
  "meta": {
    "credits_charged": 0,
    "generated_at": "string",
    "locale": "string",
    "partial": true,
    "request_id": "string",
    "requested_modules": [
      "string"
    ]
  },
  "public_procurement": {
    "processes": [
      {
        "amount": null,
        "date": null,
        "evidence_refs": [
          null
        ],
        "id": "string",
        "role": "BUYER",
        "status": null,
        "title": null
      }
    ],
    "supplier_registrations": [
      {
        "authority_name": "string",
        "evidence_refs": [
          null
        ],
        "id": "string",
        "local_name": "string",
        "registered_at": null,
        "status": "ACTIVE"
      }
    ]
  },
  "registrations": [
    {
      "authority": {
        "country": "AR",
        "local_name": "string",
        "name": "string"
      },
      "event": "string",
      "evidence_refs": [
        "string"
      ],
      "id": "string",
      "is_current": true,
      "number": "string",
      "raw_status": "string",
      "registered_at": "string",
      "renewed_at": "string",
      "status": "ACTIVE",
      "type": "COMMERCIAL_REGISTRATION"
    }
  ],
  "relationships": [
    {
      "effective_from": "string",
      "effective_to": "string",
      "evidence_refs": [
        "string"
      ],
      "id": "string",
      "subject_identifier": "string",
      "subject_name": "string",
      "type": "string"
    }
  ],
  "representatives": [
    {
      "effective_from": "string",
      "effective_to": "string",
      "evidence_refs": [
        "string"
      ],
      "id": "string",
      "is_current": true,
      "name": "string",
      "role": "string"
    }
  ],
  "sanctions": [
    {
      "amount": {
        "amount": null,
        "currency": null
      },
      "authority_name": "string",
      "decision_date": "string",
      "decision_reference": "string",
      "effective_from": "string",
      "effective_to": "string",
      "evidence_refs": [
        "string"
      ],
      "id": "string",
      "raw_type": "string",
      "status": "ACTIVE",
      "title": "string",
      "type": "string"
    }
  ],
  "schema_version": "1.0",
  "sources": [
    {
      "coverage": {
        "from": null,
        "to": null
      },
      "data_as_of": "string",
      "dataset_name": "string",
      "expected_update_frequency": "DAILY",
      "freshness": "CURRENT",
      "id": "string",
      "last_imported_at": "string",
      "latest_observation_at": "string",
      "publisher_name": "string",
      "reporting_basis": "COMPANY_DECLARED_TO_AUTHORITY",
      "source_updated_at": "string",
      "verification_url": "string"
    }
  ]
}

Procedência e limitações

A cobertura varia por país e fonte pública. Um campo ausente não comprova que o fato não exista. Os registros públicos podem ter atrasos ou erros; revise as evidências e a data da fonte antes de usar um resultado.