Perfil universal de empresa na LATAM
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
- Com apenas um nome, pesquise no registro do país e confirme a empresa. Um nome coincidente não identifica uma entidade única.
- Envie country e taxId como texto e preserve zeros iniciais. Use o identificador fiscal da empresa, nunca um DNI ou identificador pessoal.
- 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.
- 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.
- 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.
Parâmetros
countryenum<AR | CO | EC | PE | PY>CaminhoobrigatórioPaí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órioUse 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-OfAlias anterior da data de importação. Prefira os campos explícitos de atualização em sources[].
X-Latinfo-Imported-Atdate-time
X-Source-Updated-Atdate-time
X-Latest-Observation-Atdate
X-Expected-Update-Frequencystring
DAILY · WEEKLY · MONTHLY · YEARLY · MANUAL · UNKNOWNX-Freshness-Statusstring
CURRENT · DELAYED · STALE · UNKNOWNX-Verify-Liveuri
X-Credits-Costinteger
application/jsonCampos da resposta
activities array obrigatórioAtividades econômicas com classificações locais originais e equivalências internacionais disponíveis.
Campos internos
activities[].evidence_refs array obrigatórioactivities[].id string obrigatórioactivities[].international union obrigatórioCampos internos
activities[].international.code string obrigatórioactivities[].international.description string obrigatórioactivities[].international.level object obrigatórioCLASS · DIVISION · GROUP · SECTION
activities[].international.mapping_method object obrigatórioOFFICIAL_CROSSWALK · REVIEWED_CROSSWALK
activities[].international.mapping_relation object obrigatórioAPPROXIMATE · EXACT · MANY_TO_ONE · ONE_TO_MANY
activities[].international.revision object obrigatório4
activities[].international.system object obrigatórioISIC_REV4
activities[].local object obrigatórioCampos internos
activities[].local.code union obrigatórioactivities[].local.description union obrigatórioactivities[].local.revision union obrigatórioactivities[].local.system string obrigatórioactivities[].role object obrigatórioOTHER · PRIMARY · SECONDARY
addresses array obrigatórioEndereços declarados nas fontes públicas consultadas; não são locais operacionais verificados independentemente.
Campos internos
addresses[].administrative_area union obrigatórioaddresses[].country object obrigatórioAR · BO · BR · CL · CO · EC · PE · PY
addresses[].evidence_refs array obrigatórioaddresses[].full_address union obrigatórioaddresses[].id string obrigatórioaddresses[].line_1 union obrigatórioaddresses[].line_2 union obrigatórioaddresses[].local_subdivision_code union obrigatórioaddresses[].locality union obrigatórioaddresses[].postal_code union obrigatórioaddresses[].raw union obrigatórioaddresses[].type object obrigatórioFACILITY · FISCAL · OPERATING · OTHER · REGISTERED
company object obrigatórioIdentidade normalizada da empresa. primary_status corresponde a um registro específico e não é um parecer de regularidade.
Campos internos
company.country object obrigatórioCampos internos
company.country.code object obrigatórioAR · BO · BR · CL · CO · EC · PE · PY
company.country.name string obrigatóriocompany.entity_type object obrigatórioGOVERNMENT_ENTITY · LEGAL_ENTITY · ORGANIZATION
company.id string obrigatóriocompany.incorporation_date union obrigatóriocompany.legal_name string obrigatóriocompany.primary_status union obrigatórioCampos internos
company.primary_status.code object obrigatórioACTIVE · CANCELLED · DISSOLVED · INACTIVE · PENDING · SUSPENDED · UNKNOWN
company.primary_status.evidence_refs array obrigatóriocompany.primary_status.scope object obrigatórioCOMMERCIAL_REGISTRATION · FACILITY · LEGAL_ENTITY · PROCUREMENT_SUPPLIER_REGISTRATION · REGULATORY_REGISTRATION · TAX_REGISTRATION
company.trade_names array obrigatóriocoverage object obrigatórioEstado e fontes consultadas por módulo. Distingue falta de cobertura, indisponibilidade, resultados parciais e ausência de registros.
Campos internos
coverage.activities object obrigatórioCampos internos
coverage.activities.data_as_of union obrigatóriocoverage.activities.sources_checked array obrigatóriocoverage.activities.status object obrigatórioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.addresses object obrigatórioCampos internos
coverage.addresses.data_as_of union obrigatóriocoverage.addresses.sources_checked array obrigatóriocoverage.addresses.status object obrigatórioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.customs object obrigatórioCampos internos
coverage.customs.data_as_of union obrigatóriocoverage.customs.sources_checked array obrigatóriocoverage.customs.status object obrigatórioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.debts object obrigatórioCampos internos
coverage.debts.data_as_of union obrigatóriocoverage.debts.sources_checked array obrigatóriocoverage.debts.status object obrigatórioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.extensions object obrigatórioCampos internos
coverage.extensions.data_as_of union obrigatóriocoverage.extensions.sources_checked array obrigatóriocoverage.extensions.status object obrigatórioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.facilities object obrigatórioCampos internos
coverage.facilities.data_as_of union obrigatóriocoverage.facilities.sources_checked array obrigatóriocoverage.facilities.status object obrigatórioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.identity object obrigatórioCampos internos
coverage.identity.data_as_of union obrigatóriocoverage.identity.sources_checked array obrigatóriocoverage.identity.status object obrigatórioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.public_procurement object obrigatórioCampos internos
coverage.public_procurement.data_as_of union obrigatóriocoverage.public_procurement.sources_checked array obrigatóriocoverage.public_procurement.status object obrigatórioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.registrations object obrigatórioCampos internos
coverage.registrations.data_as_of union obrigatóriocoverage.registrations.sources_checked array obrigatóriocoverage.registrations.status object obrigatórioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.relationships object obrigatórioCampos internos
coverage.relationships.data_as_of union obrigatóriocoverage.relationships.sources_checked array obrigatóriocoverage.relationships.status object obrigatórioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.representatives object obrigatórioCampos internos
coverage.representatives.data_as_of union obrigatóriocoverage.representatives.sources_checked array obrigatóriocoverage.representatives.status object obrigatórioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.sanctions object obrigatórioCampos internos
coverage.sanctions.data_as_of union obrigatóriocoverage.sanctions.sources_checked array obrigatóriocoverage.sanctions.status object obrigatórioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.statuses object obrigatórioCampos internos
coverage.statuses.data_as_of union obrigatóriocoverage.statuses.sources_checked array obrigatóriocoverage.statuses.status object obrigatórioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.supervision object obrigatórioCampos internos
coverage.supervision.data_as_of union obrigatóriocoverage.supervision.sources_checked array obrigatóriocoverage.supervision.status object obrigatórioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
customs object obrigatórioOperaçõ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órioCampos internos
customs.operations[].declaration string obrigatóriocustoms.operations[].description union obrigatóriocustoms.operations[].evidence_refs array obrigatóriocustoms.operations[].fob_usd union obrigatóriocustoms.operations[].hs_code string obrigatóriocustoms.operations[].id string obrigatóriocustoms.operations[].net_weight_kg union obrigatóriocustoms.operations[].operation_date union obrigatóriocustoms.operations[].operation_type object obrigatórioEXPORT · IMPORT
customs.operations[].partner_country union obrigatóriocustoms.summary union obrigatórioCampos internos
customs.summary.first_operation_date union obrigatóriocustoms.summary.last_operation_date union obrigatóriocustoms.summary.operation_count integer obrigatóriocustoms.summary.total_fob_usd union obrigatóriocustoms.summary.total_net_weight_kg union obrigatóriodebts array obrigatórioDívidas publicadas. Preserve o valor, a moeda, o período e a evidência.
Campos internos
debts[].amount union obrigatórioCampos internos
debts[].amount.amount string obrigatóriodebts[].amount.currency string obrigatóriodebts[].evidence_refs array obrigatóriodebts[].id string obrigatóriodebts[].observed_at union obrigatóriodebts[].status object obrigatórioPUBLISHED · SETTLED · UNKNOWN
debts[].type string obrigatórioevidence array obrigatórioEvidê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órioevidence[].data_as_of union obrigatórioevidence[].id string obrigatórioevidence[].license union obrigatórioevidence[].publisher object obrigatórioCampos internos
evidence[].publisher.acronym union obrigatórioevidence[].publisher.country string obrigatórioevidence[].publisher.local_name string obrigatórioevidence[].reporting_basis object obrigatórioCOMPANY_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órioevidence[].source_record object obrigatórioevidence[].verification_url union obrigatórioextensions object obrigatórioDados específicos das fontes fora dos módulos normalizados; consulte o contrato da fonte.
facilities array obrigatórioEstabelecimentos registrados nas fontes oficiais disponíveis.
Campos internos
facilities[].address union obrigatórioCampos internos
facilities[].address.administrative_area union obrigatóriofacilities[].address.country object obrigatórioAR · BO · BR · CL · CO · EC · PE · PY
facilities[].address.evidence_refs array obrigatóriofacilities[].address.full_address union obrigatóriofacilities[].address.id string obrigatóriofacilities[].address.line_1 union obrigatóriofacilities[].address.line_2 union obrigatóriofacilities[].address.local_subdivision_code union obrigatóriofacilities[].address.locality union obrigatóriofacilities[].address.postal_code union obrigatóriofacilities[].address.raw union obrigatóriofacilities[].address.type object obrigatórioFACILITY · FISCAL · OPERATING · OTHER · REGISTERED
facilities[].evidence_refs array obrigatóriofacilities[].id string obrigatóriofacilities[].name union obrigatóriofacilities[].status union obrigatóriofacilities[].type string obrigatórioidentifiers array obrigatórioIdentificadores fiscais de empresas, associados a um país. Preserve-os como texto, incluindo zeros iniciais.
Campos internos
identifiers[].check_digit union obrigatórioidentifiers[].country object obrigatórioAR · BO · BR · CL · CO · EC · PE · PY
identifiers[].evidence_refs array obrigatórioidentifiers[].formatted string obrigatórioidentifiers[].local_name string obrigatórioidentifiers[].scheme object obrigatórioAR_CUIT · BO_NIT · BR_CNPJ · CL_RUT · CO_NIT · EC_RUC · PE_RUC · PY_RUC
identifiers[].type object obrigatórioTAX_ID
identifiers[].value string obrigatóriometa object obrigatórioMetadados 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óriometa.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óriometa.partial boolean obrigatóriometa.request_id string obrigatóriometa.requested_modules array obrigatóriopublic_procurement object obrigatórioRegistros de fornecedores e processos de contratação, preservados como observações distintas.
Campos internos
public_procurement.processes array obrigatórioCampos internos
public_procurement.processes[].amount union obrigatórioCampos internos
public_procurement.processes[].amount.amount string obrigatóriopublic_procurement.processes[].amount.currency string obrigatóriopublic_procurement.processes[].date union obrigatóriopublic_procurement.processes[].evidence_refs array obrigatóriopublic_procurement.processes[].id string obrigatóriopublic_procurement.processes[].role object obrigatórioBUYER · CONSORTIUM_MEMBER · OTHER · SUPPLIER
public_procurement.processes[].status union obrigatóriopublic_procurement.processes[].title union obrigatóriopublic_procurement.supplier_registrations array obrigatórioCampos internos
public_procurement.supplier_registrations[].authority_name string obrigatóriopublic_procurement.supplier_registrations[].evidence_refs array obrigatóriopublic_procurement.supplier_registrations[].id string obrigatóriopublic_procurement.supplier_registrations[].local_name string obrigatóriopublic_procurement.supplier_registrations[].registered_at union obrigatóriopublic_procurement.supplier_registrations[].status object obrigatórioACTIVE · CANCELLED · INACTIVE · SUSPENDED · UNKNOWN
registrations array obrigatórioRegistros nos conjuntos de dados oficiais consultados; a cobertura não é exaustiva.
Campos internos
registrations[].authority object obrigatórioCampos internos
registrations[].authority.country object obrigatórioAR · BO · BR · CL · CO · EC · PE · PY
registrations[].authority.local_name string obrigatórioregistrations[].authority.name string obrigatórioregistrations[].event union obrigatórioregistrations[].evidence_refs array obrigatórioregistrations[].id string obrigatórioregistrations[].is_current union obrigatórioregistrations[].number union obrigatórioregistrations[].raw_status union obrigatórioregistrations[].registered_at union obrigatórioregistrations[].renewed_at union obrigatórioregistrations[].status object obrigatórioACTIVE · CANCELLED · INACTIVE · PENDING · SUSPENDED · UNKNOWN
registrations[].type object obrigatórioCOMMERCIAL_REGISTRATION · OTHER · PUBLIC_PROCUREMENT_SUPPLIER · REGULATORY_REGISTRATION · TAX_REGISTRATION
relationships array obrigatórioRelações publicadas pelas fontes; não deduza propriedade não declarada.
Campos internos
relationships[].effective_from union obrigatóriorelationships[].effective_to union obrigatóriorelationships[].evidence_refs array obrigatóriorelationships[].id string obrigatóriorelationships[].subject_identifier union obrigatóriorelationships[].subject_name union obrigatóriorelationships[].type string obrigatóriorepresentatives array obrigatórioCargos e representação legal publicados; não determinam o beneficiário final.
Campos internos
representatives[].effective_from union obrigatóriorepresentatives[].effective_to union obrigatóriorepresentatives[].evidence_refs array obrigatóriorepresentatives[].id string obrigatóriorepresentatives[].is_current union obrigatóriorepresentatives[].name string obrigatóriorepresentatives[].role string obrigatóriosanctions array obrigatórioSanções encontradas nas fontes consultadas. Uma lista vazia não comprova ausência de sanções.
Campos internos
sanctions[].amount union obrigatórioCampos internos
sanctions[].amount.amount string obrigatóriosanctions[].amount.currency string obrigatóriosanctions[].authority_name string obrigatóriosanctions[].decision_date union obrigatóriosanctions[].decision_reference union obrigatóriosanctions[].effective_from union obrigatóriosanctions[].effective_to union obrigatóriosanctions[].evidence_refs array obrigatóriosanctions[].id string obrigatóriosanctions[].raw_type union obrigatóriosanctions[].status object obrigatórioACTIVE · COMPLETED · EXPIRED · UNKNOWN
sanctions[].title union obrigatóriosanctions[].type string obrigatórioschema_version object obrigatórioVersão do contrato de resposta; use-a para detectar alterações incompatíveis.
1.0
sources array obrigatórioConjuntos 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órioCampos internos
sources[].coverage.from union obrigatóriosources[].coverage.to union obrigatóriosources[].data_as_of union obrigatóriosources[].dataset_name string obrigatóriosources[].expected_update_frequency object obrigatórioDAILY · MANUAL · MONTHLY · UNKNOWN · WEEKLY · YEARLY
sources[].freshness object obrigatórioCURRENT · DELAYED · STALE · UNKNOWN
sources[].id string obrigatóriosources[].last_imported_at union obrigatóriosources[].latest_observation_at union obrigatóriosources[].publisher_name string obrigatóriosources[].reporting_basis object obrigatórioCOMPANY_DECLARED_TO_AUTHORITY · LATINFO_DERIVED · OFFICIAL_PUBLICATION · OFFICIAL_REGISTRY · THIRD_PARTY_DECLARED_TO_AUTHORITY
sources[].source_updated_at union obrigatóriosources[].verification_url union obrigatóriostatuses array obrigatórioObservaçõ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órioACTIVE · CANCELLED · DISSOLVED · INACTIVE · PENDING · SUSPENDED · UNKNOWN
statuses[].effective_from union obrigatóriostatuses[].effective_to union obrigatóriostatuses[].evidence_refs array obrigatóriostatuses[].explanation union obrigatóriostatuses[].id string obrigatóriostatuses[].label string obrigatóriostatuses[].raw object obrigatórioCampos internos
statuses[].raw.language string obrigatóriostatuses[].raw.value string obrigatóriostatuses[].scope object obrigatórioCOMMERCIAL_REGISTRATION · FACILITY · LEGAL_ENTITY · PROCUREMENT_SUPPLIER_REGISTRATION · REGULATORY_REGISTRATION · TAX_REGISTRATION
supervision array obrigatórioObservações de supervisão ou registro setorial das autoridades consultadas.
Campos internos
supervision[].authority_name string obrigatóriosupervision[].evidence_refs array obrigatóriosupervision[].id string obrigatóriosupervision[].registration_type string obrigatóriosupervision[].status union obrigatórioEsquema 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
401Chave de api ausente ou inválida
404Empresa não encontrada
429Limite de requisições excedido
501País ainda não incorporado ao contrato universal
503O comprovante vigente de disponibilidade semântica está indisponível ou desatualizado
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.