Perfil universal de empresa en LATAM
https://api.latinfo.dev/v1/companies/{country}/{taxId}
Usa el perfil universal solo para países incluidos en el enum del parámetro country. Para otros países publicados, elige una consulta por fuente en /catalog. Tener una fuente publicada no implica contar con un perfil universal certificado.
Flujo de integración
- Si solo tienes un nombre, busca en el registro del país y confirma la empresa. Una coincidencia de nombre no identifica de forma única.
- Envía country y taxId como texto y conserva los ceros iniciales. Usa el identificador fiscal de la empresa, nunca un DNI ni un identificador personal.
- Lee coverage para cada módulo antes de interpretar sus listas. NO_RECORDS significa que no hay registros en las fuentes consultadas; NOT_SUPPORTED significa que el módulo no está cubierto.
- Resuelve evidence_refs con evidence[].id y source_id con sources[].id. Cita el publicador, el enlace de verificación y la fecha de observación para cada afirmación relevante.
- Comprueba meta.partial y sources[].freshness. Indica explícitamente SOURCE_UNAVAILABLE, PARTIAL y UNKNOWN cuando aparezcan.
Límites de interpretación
- El estado de inscripción corresponde a un registro específico. ACTIVE no es un dictamen general de cumplimiento.
- Las listas vacías y los campos null no prueban la ausencia de sanciones, deudas o relaciones.
- last_imported_at es la fecha de ingesta en Latinfo; source_updated_at y latest_observation_at representan fechas distintas de la fuente.
Parámetros
countryenum<AR | CO | EC | PE | PY>RutaobligatorioPaís ISO 3166-1 alfa-2 con un perfil nativo certificado activo. La consulta externa por fuente no implica certificación del perfil universal. Los países sin perfil nativo activo devuelven 501; los identificadores malformados devuelven 400.
Example: AR
taxIdstringRutaobligatorioUsa el identificador fiscal empresarial local de un país incluido en el enum country. Mantén los identificadores como texto y conserva los ceros iniciales. Se acepta puntuación.
Example: 30500000127
Ejemplo de solicitud
curl https://api.latinfo.dev/v1/companies/AR/30500000127 \
-H "Authorization: Bearer $LATINFO_API_KEY"
Respuestas
200Perfil de empresa con evidencia de fuentes y cobertura por módulo
Encabezados de la respuesta
X-Data-As-OfAlias anterior de fecha de importación. Prefiere los campos explícitos de actualización en 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 de la respuesta
activities array obligatorioActividades económicas con sus clasificaciones locales originales y equivalencias internacionales disponibles.
Campos internos
activities[].evidence_refs array obligatorioactivities[].id string obligatorioactivities[].international union obligatorioCampos internos
activities[].international.code string obligatorioactivities[].international.description string obligatorioactivities[].international.level object obligatorioCLASS · DIVISION · GROUP · SECTION
activities[].international.mapping_method object obligatorioOFFICIAL_CROSSWALK · REVIEWED_CROSSWALK
activities[].international.mapping_relation object obligatorioAPPROXIMATE · EXACT · MANY_TO_ONE · ONE_TO_MANY
activities[].international.revision object obligatorio4
activities[].international.system object obligatorioISIC_REV4
activities[].local object obligatorioCampos internos
activities[].local.code union obligatorioactivities[].local.description union obligatorioactivities[].local.revision union obligatorioactivities[].local.system string obligatorioactivities[].role object obligatorioOTHER · PRIMARY · SECONDARY
addresses array obligatorioDirecciones declaradas en las fuentes públicas consultadas; no son ubicaciones operativas verificadas de forma independiente.
Campos internos
addresses[].administrative_area union obligatorioaddresses[].country object obligatorioAR · BO · BR · CL · CO · EC · PE · PY
addresses[].evidence_refs array obligatorioaddresses[].full_address union obligatorioaddresses[].id string obligatorioaddresses[].line_1 union obligatorioaddresses[].line_2 union obligatorioaddresses[].local_subdivision_code union obligatorioaddresses[].locality union obligatorioaddresses[].postal_code union obligatorioaddresses[].raw union obligatorioaddresses[].type object obligatorioFACILITY · FISCAL · OPERATING · OTHER · REGISTERED
company object obligatorioIdentidad normalizada de la empresa. primary_status corresponde a un registro específico y no es un dictamen de cumplimiento.
Campos internos
company.country object obligatorioCampos internos
company.country.code object obligatorioAR · BO · BR · CL · CO · EC · PE · PY
company.country.name string obligatoriocompany.entity_type object obligatorioGOVERNMENT_ENTITY · LEGAL_ENTITY · ORGANIZATION
company.id string obligatoriocompany.incorporation_date union obligatoriocompany.legal_name string obligatoriocompany.primary_status union obligatorioCampos internos
company.primary_status.code object obligatorioACTIVE · CANCELLED · DISSOLVED · INACTIVE · PENDING · SUSPENDED · UNKNOWN
company.primary_status.evidence_refs array obligatoriocompany.primary_status.scope object obligatorioCOMMERCIAL_REGISTRATION · FACILITY · LEGAL_ENTITY · PROCUREMENT_SUPPLIER_REGISTRATION · REGULATORY_REGISTRATION · TAX_REGISTRATION
company.trade_names array obligatoriocoverage object obligatorioEstado y fuentes consultadas por módulo. Distingue falta de cobertura, indisponibilidad, resultados parciales y ausencia de registros.
Campos internos
coverage.activities object obligatorioCampos internos
coverage.activities.data_as_of union obligatoriocoverage.activities.sources_checked array obligatoriocoverage.activities.status object obligatorioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.addresses object obligatorioCampos internos
coverage.addresses.data_as_of union obligatoriocoverage.addresses.sources_checked array obligatoriocoverage.addresses.status object obligatorioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.customs object obligatorioCampos internos
coverage.customs.data_as_of union obligatoriocoverage.customs.sources_checked array obligatoriocoverage.customs.status object obligatorioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.debts object obligatorioCampos internos
coverage.debts.data_as_of union obligatoriocoverage.debts.sources_checked array obligatoriocoverage.debts.status object obligatorioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.extensions object obligatorioCampos internos
coverage.extensions.data_as_of union obligatoriocoverage.extensions.sources_checked array obligatoriocoverage.extensions.status object obligatorioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.facilities object obligatorioCampos internos
coverage.facilities.data_as_of union obligatoriocoverage.facilities.sources_checked array obligatoriocoverage.facilities.status object obligatorioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.identity object obligatorioCampos internos
coverage.identity.data_as_of union obligatoriocoverage.identity.sources_checked array obligatoriocoverage.identity.status object obligatorioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.public_procurement object obligatorioCampos internos
coverage.public_procurement.data_as_of union obligatoriocoverage.public_procurement.sources_checked array obligatoriocoverage.public_procurement.status object obligatorioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.registrations object obligatorioCampos internos
coverage.registrations.data_as_of union obligatoriocoverage.registrations.sources_checked array obligatoriocoverage.registrations.status object obligatorioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.relationships object obligatorioCampos internos
coverage.relationships.data_as_of union obligatoriocoverage.relationships.sources_checked array obligatoriocoverage.relationships.status object obligatorioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.representatives object obligatorioCampos internos
coverage.representatives.data_as_of union obligatoriocoverage.representatives.sources_checked array obligatoriocoverage.representatives.status object obligatorioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.sanctions object obligatorioCampos internos
coverage.sanctions.data_as_of union obligatoriocoverage.sanctions.sources_checked array obligatoriocoverage.sanctions.status object obligatorioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.statuses object obligatorioCampos internos
coverage.statuses.data_as_of union obligatoriocoverage.statuses.sources_checked array obligatoriocoverage.statuses.status object obligatorioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
coverage.supervision object obligatorioCampos internos
coverage.supervision.data_as_of union obligatoriocoverage.supervision.sources_checked array obligatoriocoverage.supervision.status object obligatorioAVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE
customs object obligatorioOperaciones y resúmenes aduaneros publicados. Los valores FOB están en USD y los pesos netos en kilogramos.
Campos internos
customs.operations array obligatorioCampos internos
customs.operations[].declaration string obligatoriocustoms.operations[].description union obligatoriocustoms.operations[].evidence_refs array obligatoriocustoms.operations[].fob_usd union obligatoriocustoms.operations[].hs_code string obligatoriocustoms.operations[].id string obligatoriocustoms.operations[].net_weight_kg union obligatoriocustoms.operations[].operation_date union obligatoriocustoms.operations[].operation_type object obligatorioEXPORT · IMPORT
customs.operations[].partner_country union obligatoriocustoms.summary union obligatorioCampos internos
customs.summary.first_operation_date union obligatoriocustoms.summary.last_operation_date union obligatoriocustoms.summary.operation_count integer obligatoriocustoms.summary.total_fob_usd union obligatoriocustoms.summary.total_net_weight_kg union obligatoriodebts array obligatorioDeudas publicadas. Conserva el importe, la moneda, el periodo y la evidencia.
Campos internos
debts[].amount union obligatorioCampos internos
debts[].amount.amount string obligatoriodebts[].amount.currency string obligatoriodebts[].evidence_refs array obligatoriodebts[].id string obligatoriodebts[].observed_at union obligatoriodebts[].status object obligatorioPUBLISHED · SETTLED · UNKNOWN
debts[].type string obligatorioevidence array obligatorioEvidencia de cada afirmación. Resuelve evidence_refs con estos identificadores estables y cita el publicador y el enlace de verificación.
Campos internos
evidence[].claims array obligatorioevidence[].data_as_of union obligatorioevidence[].id string obligatorioevidence[].license union obligatorioevidence[].publisher object obligatorioCampos internos
evidence[].publisher.acronym union obligatorioevidence[].publisher.country string obligatorioevidence[].publisher.local_name string obligatorioevidence[].reporting_basis object obligatorioCOMPANY_DECLARED_TO_AUTHORITY · LATINFO_DERIVED · OFFICIAL_PUBLICATION · OFFICIAL_REGISTRY · THIRD_PARTY_DECLARED_TO_AUTHORITY
evidence[].retrieved_at string obligatorio^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$
evidence[].source_id string obligatorioevidence[].source_record object obligatorioevidence[].verification_url union obligatorioextensions object obligatorioDatos específicos de las fuentes fuera de los módulos normalizados; consulta el contrato de la fuente.
facilities array obligatorioEstablecimientos registrados en las fuentes oficiales disponibles.
Campos internos
facilities[].address union obligatorioCampos internos
facilities[].address.administrative_area union obligatoriofacilities[].address.country object obligatorioAR · BO · BR · CL · CO · EC · PE · PY
facilities[].address.evidence_refs array obligatoriofacilities[].address.full_address union obligatoriofacilities[].address.id string obligatoriofacilities[].address.line_1 union obligatoriofacilities[].address.line_2 union obligatoriofacilities[].address.local_subdivision_code union obligatoriofacilities[].address.locality union obligatoriofacilities[].address.postal_code union obligatoriofacilities[].address.raw union obligatoriofacilities[].address.type object obligatorioFACILITY · FISCAL · OPERATING · OTHER · REGISTERED
facilities[].evidence_refs array obligatoriofacilities[].id string obligatoriofacilities[].name union obligatoriofacilities[].status union obligatoriofacilities[].type string obligatorioidentifiers array obligatorioIdentificadores fiscales de empresas, asociados a un país. Consérvalos como texto, incluidos los ceros iniciales.
Campos internos
identifiers[].check_digit union obligatorioidentifiers[].country object obligatorioAR · BO · BR · CL · CO · EC · PE · PY
identifiers[].evidence_refs array obligatorioidentifiers[].formatted string obligatorioidentifiers[].local_name string obligatorioidentifiers[].scheme object obligatorioAR_CUIT · BO_NIT · BR_CNPJ · CL_RUT · CO_NIT · EC_RUC · PE_RUC · PY_RUC
identifiers[].type object obligatorioTAX_ID
identifiers[].value string obligatoriometa object obligatorioMetadatos de la solicitud, módulos solicitados y marca de resultado parcial. El campo histórico credits_charged siempre es cero; el acceso es gratuito.
Campos internos
meta.credits_charged integer obligatoriometa.generated_at string obligatorio^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$
meta.locale string obligatoriometa.partial boolean obligatoriometa.request_id string obligatoriometa.requested_modules array obligatoriopublic_procurement object obligatorioInscripciones de proveedores y procesos de contratación, conservados como observaciones distintas.
Campos internos
public_procurement.processes array obligatorioCampos internos
public_procurement.processes[].amount union obligatorioCampos internos
public_procurement.processes[].amount.amount string obligatoriopublic_procurement.processes[].amount.currency string obligatoriopublic_procurement.processes[].date union obligatoriopublic_procurement.processes[].evidence_refs array obligatoriopublic_procurement.processes[].id string obligatoriopublic_procurement.processes[].role object obligatorioBUYER · CONSORTIUM_MEMBER · OTHER · SUPPLIER
public_procurement.processes[].status union obligatoriopublic_procurement.processes[].title union obligatoriopublic_procurement.supplier_registrations array obligatorioCampos internos
public_procurement.supplier_registrations[].authority_name string obligatoriopublic_procurement.supplier_registrations[].evidence_refs array obligatoriopublic_procurement.supplier_registrations[].id string obligatoriopublic_procurement.supplier_registrations[].local_name string obligatoriopublic_procurement.supplier_registrations[].registered_at union obligatoriopublic_procurement.supplier_registrations[].status object obligatorioACTIVE · CANCELLED · INACTIVE · SUSPENDED · UNKNOWN
registrations array obligatorioInscripciones en los conjuntos de datos oficiales consultados; la cobertura no es exhaustiva.
Campos internos
registrations[].authority object obligatorioCampos internos
registrations[].authority.country object obligatorioAR · BO · BR · CL · CO · EC · PE · PY
registrations[].authority.local_name string obligatorioregistrations[].authority.name string obligatorioregistrations[].event union obligatorioregistrations[].evidence_refs array obligatorioregistrations[].id string obligatorioregistrations[].is_current union obligatorioregistrations[].number union obligatorioregistrations[].raw_status union obligatorioregistrations[].registered_at union obligatorioregistrations[].renewed_at union obligatorioregistrations[].status object obligatorioACTIVE · CANCELLED · INACTIVE · PENDING · SUSPENDED · UNKNOWN
registrations[].type object obligatorioCOMMERCIAL_REGISTRATION · OTHER · PUBLIC_PROCUREMENT_SUPPLIER · REGULATORY_REGISTRATION · TAX_REGISTRATION
relationships array obligatorioRelaciones publicadas por las fuentes; no deduzcas propiedad no declarada.
Campos internos
relationships[].effective_from union obligatoriorelationships[].effective_to union obligatoriorelationships[].evidence_refs array obligatoriorelationships[].id string obligatoriorelationships[].subject_identifier union obligatoriorelationships[].subject_name union obligatoriorelationships[].type string obligatoriorepresentatives array obligatorioCargos y representación legal publicados; no determinan el beneficiario final.
Campos internos
representatives[].effective_from union obligatoriorepresentatives[].effective_to union obligatoriorepresentatives[].evidence_refs array obligatoriorepresentatives[].id string obligatoriorepresentatives[].is_current union obligatoriorepresentatives[].name string obligatoriorepresentatives[].role string obligatoriosanctions array obligatorioSanciones encontradas en las fuentes consultadas. Una lista vacía no acredita ausencia de sanciones.
Campos internos
sanctions[].amount union obligatorioCampos internos
sanctions[].amount.amount string obligatoriosanctions[].amount.currency string obligatoriosanctions[].authority_name string obligatoriosanctions[].decision_date union obligatoriosanctions[].decision_reference union obligatoriosanctions[].effective_from union obligatoriosanctions[].effective_to union obligatoriosanctions[].evidence_refs array obligatoriosanctions[].id string obligatoriosanctions[].raw_type union obligatoriosanctions[].status object obligatorioACTIVE · COMPLETED · EXPIRED · UNKNOWN
sanctions[].title union obligatoriosanctions[].type string obligatorioschema_version object obligatorioVersión del contrato de respuesta; úsala para detectar cambios incompatibles.
1.0
sources array obligatorioConjuntos de datos consultados y fechas explícitas de actualización. La fecha de ingesta no es la fecha de observación.
Campos internos
sources[].coverage object obligatorioCampos internos
sources[].coverage.from union obligatoriosources[].coverage.to union obligatoriosources[].data_as_of union obligatoriosources[].dataset_name string obligatoriosources[].expected_update_frequency object obligatorioDAILY · MANUAL · MONTHLY · UNKNOWN · WEEKLY · YEARLY
sources[].freshness object obligatorioCURRENT · DELAYED · STALE · UNKNOWN
sources[].id string obligatoriosources[].last_imported_at union obligatoriosources[].latest_observation_at union obligatoriosources[].publisher_name string obligatoriosources[].reporting_basis object obligatorioCOMPANY_DECLARED_TO_AUTHORITY · LATINFO_DERIVED · OFFICIAL_PUBLICATION · OFFICIAL_REGISTRY · THIRD_PARTY_DECLARED_TO_AUTHORITY
sources[].source_updated_at union obligatoriosources[].verification_url union obligatoriostatuses array obligatorioObservaciones de registros distintos. Conserva el ámbito, la etiqueta original y la evidencia; no deduzcas un dictamen global.
Campos internos
statuses[].code object obligatorioACTIVE · CANCELLED · DISSOLVED · INACTIVE · PENDING · SUSPENDED · UNKNOWN
statuses[].effective_from union obligatoriostatuses[].effective_to union obligatoriostatuses[].evidence_refs array obligatoriostatuses[].explanation union obligatoriostatuses[].id string obligatoriostatuses[].label string obligatoriostatuses[].raw object obligatorioCampos internos
statuses[].raw.language string obligatoriostatuses[].raw.value string obligatoriostatuses[].scope object obligatorioCOMMERCIAL_REGISTRATION · FACILITY · LEGAL_ENTITY · PROCUREMENT_SUPPLIER_REGISTRATION · REGULATORY_REGISTRATION · TAX_REGISTRATION
supervision array obligatorioObservaciones de supervisión o inscripción sectorial de las autoridades consultadas.
Campos internos
supervision[].authority_name string obligatoriosupervision[].evidence_refs array obligatoriosupervision[].id string obligatoriosupervision[].registration_type string obligatoriosupervision[].status union obligatorioEsquema de respuesta
{
"$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 el país
401Clave de api ausente o inválida
404Empresa no encontrada
429Límite de solicitudes excedido
501País aún no incorporado al contrato universal
503El comprobante vigente de disponibilidad semántica no está disponible o está desactualizado
Ejemplo JSON
Ejemplo ilustrativo del esquema. No es una respuesta en 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"
}
]
}Procedencia y limitaciones
La cobertura varía por país y fuente pública. Un campo ausente no demuestra que el hecho no exista. Los registros públicos pueden tener retrasos o errores; revisa la evidencia y la fecha de la fuente antes de usar un resultado.