API universal de empresas · getUniversalCompany
OpenAPI

Perfil universal de empresa en LATAM

GET 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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

Consulta los contratos de fuentes disponibles

Requiere autenticación. Las solicitudes REST usan una clave de api de Latinfo. La consola agrega el encabezado de autorización y no guarda la clave.

Parámetros

countryenum<AR | CO | EC | PE | PY>Rutaobligatorio

Paí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
taxIdstringRutaobligatorio

Usa 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-Of

Alias anterior de fecha de importación. Prefiere los campos explícitos de actualización en sources[].

X-Latinfo-Imported-At

date-time

X-Source-Updated-At

date-time

X-Latest-Observation-At

date

X-Expected-Update-Frequency

string

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

string

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

uri

X-Credits-Cost

integer

Content-Type: application/json

Campos de la respuesta

activities array obligatorio

Actividades económicas con sus clasificaciones locales originales y equivalencias internacionales disponibles.

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

CLASS · DIVISION · GROUP · SECTION

activities[].international.mapping_method object obligatorio

OFFICIAL_CROSSWALK · REVIEWED_CROSSWALK

activities[].international.mapping_relation object obligatorio

APPROXIMATE · EXACT · MANY_TO_ONE · ONE_TO_MANY

activities[].international.revision object obligatorio

4

activities[].international.system object obligatorio

ISIC_REV4

activities[].local object obligatorio
Campos internos
activities[].local.code union obligatorio
activities[].local.description union obligatorio
activities[].local.revision union obligatorio
activities[].local.system string obligatorio
activities[].role object obligatorio

OTHER · PRIMARY · SECONDARY

addresses array obligatorio

Direcciones declaradas en las fuentes públicas consultadas; no son ubicaciones operativas verificadas de forma independiente.

Campos internos
addresses[].administrative_area union obligatorio
addresses[].country object obligatorio

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

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

FACILITY · FISCAL · OPERATING · OTHER · REGISTERED

company object obligatorio

Identidad normalizada de la empresa. primary_status corresponde a un registro específico y no es un dictamen de cumplimiento.

Campos internos
company.country object obligatorio
Campos internos
company.country.code object obligatorio

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

company.country.name string obligatorio
company.entity_type object obligatorio

GOVERNMENT_ENTITY · LEGAL_ENTITY · ORGANIZATION

company.id string obligatorio
company.incorporation_date union obligatorio
company.legal_name string obligatorio
company.primary_status union obligatorio
Campos internos
company.primary_status.code object obligatorio

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

company.primary_status.evidence_refs array obligatorio
company.primary_status.scope object obligatorio

COMMERCIAL_REGISTRATION · FACILITY · LEGAL_ENTITY · PROCUREMENT_SUPPLIER_REGISTRATION · REGULATORY_REGISTRATION · TAX_REGISTRATION

company.trade_names array obligatorio
coverage object obligatorio

Estado y fuentes consultadas por módulo. Distingue falta de cobertura, indisponibilidad, resultados parciales y ausencia de registros.

Campos internos
coverage.activities object obligatorio
Campos internos
coverage.activities.data_as_of union obligatorio
coverage.activities.sources_checked array obligatorio
coverage.activities.status object obligatorio

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.addresses object obligatorio
Campos internos
coverage.addresses.data_as_of union obligatorio
coverage.addresses.sources_checked array obligatorio
coverage.addresses.status object obligatorio

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.customs object obligatorio
Campos internos
coverage.customs.data_as_of union obligatorio
coverage.customs.sources_checked array obligatorio
coverage.customs.status object obligatorio

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.debts object obligatorio
Campos internos
coverage.debts.data_as_of union obligatorio
coverage.debts.sources_checked array obligatorio
coverage.debts.status object obligatorio

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.extensions object obligatorio
Campos internos
coverage.extensions.data_as_of union obligatorio
coverage.extensions.sources_checked array obligatorio
coverage.extensions.status object obligatorio

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.facilities object obligatorio
Campos internos
coverage.facilities.data_as_of union obligatorio
coverage.facilities.sources_checked array obligatorio
coverage.facilities.status object obligatorio

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.identity object obligatorio
Campos internos
coverage.identity.data_as_of union obligatorio
coverage.identity.sources_checked array obligatorio
coverage.identity.status object obligatorio

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.public_procurement object obligatorio
Campos internos
coverage.public_procurement.data_as_of union obligatorio
coverage.public_procurement.sources_checked array obligatorio
coverage.public_procurement.status object obligatorio

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.registrations object obligatorio
Campos internos
coverage.registrations.data_as_of union obligatorio
coverage.registrations.sources_checked array obligatorio
coverage.registrations.status object obligatorio

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.relationships object obligatorio
Campos internos
coverage.relationships.data_as_of union obligatorio
coverage.relationships.sources_checked array obligatorio
coverage.relationships.status object obligatorio

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.representatives object obligatorio
Campos internos
coverage.representatives.data_as_of union obligatorio
coverage.representatives.sources_checked array obligatorio
coverage.representatives.status object obligatorio

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.sanctions object obligatorio
Campos internos
coverage.sanctions.data_as_of union obligatorio
coverage.sanctions.sources_checked array obligatorio
coverage.sanctions.status object obligatorio

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.statuses object obligatorio
Campos internos
coverage.statuses.data_as_of union obligatorio
coverage.statuses.sources_checked array obligatorio
coverage.statuses.status object obligatorio

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

coverage.supervision object obligatorio
Campos internos
coverage.supervision.data_as_of union obligatorio
coverage.supervision.sources_checked array obligatorio
coverage.supervision.status object obligatorio

AVAILABLE · NOT_REQUESTED · NOT_SUPPORTED · NO_RECORDS · PARTIAL · SOURCE_UNAVAILABLE

customs object obligatorio

Operaciones y resúmenes aduaneros publicados. Los valores FOB están en USD y los pesos netos en kilogramos.

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

EXPORT · IMPORT

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

Deudas publicadas. Conserva el importe, la moneda, el periodo y la evidencia.

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

PUBLISHED · SETTLED · UNKNOWN

debts[].type string obligatorio
evidence array obligatorio

Evidencia 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 obligatorio
evidence[].data_as_of union obligatorio
evidence[].id string obligatorio
evidence[].license union obligatorio
evidence[].publisher object obligatorio
Campos internos
evidence[].publisher.acronym union obligatorio
evidence[].publisher.country string obligatorio
evidence[].publisher.local_name string obligatorio
evidence[].reporting_basis object obligatorio

COMPANY_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 obligatorio
evidence[].source_record object obligatorio
evidence[].verification_url union obligatorio
extensions object obligatorio

Datos específicos de las fuentes fuera de los módulos normalizados; consulta el contrato de la fuente.

facilities array obligatorio

Establecimientos registrados en las fuentes oficiales disponibles.

Campos internos
facilities[].address union obligatorio
Campos internos
facilities[].address.administrative_area union obligatorio
facilities[].address.country object obligatorio

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

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

FACILITY · FISCAL · OPERATING · OTHER · REGISTERED

facilities[].evidence_refs array obligatorio
facilities[].id string obligatorio
facilities[].name union obligatorio
facilities[].status union obligatorio
facilities[].type string obligatorio
identifiers array obligatorio

Identificadores fiscales de empresas, asociados a un país. Consérvalos como texto, incluidos los ceros iniciales.

Campos internos
identifiers[].check_digit union obligatorio
identifiers[].country object obligatorio

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

identifiers[].evidence_refs array obligatorio
identifiers[].formatted string obligatorio
identifiers[].local_name string obligatorio
identifiers[].scheme object obligatorio

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

identifiers[].type object obligatorio

TAX_ID

identifiers[].value string obligatorio
meta object obligatorio

Metadatos 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 obligatorio
meta.generated_at string obligatorio

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

meta.locale string obligatorio
meta.partial boolean obligatorio
meta.request_id string obligatorio
meta.requested_modules array obligatorio
public_procurement object obligatorio

Inscripciones de proveedores y procesos de contratación, conservados como observaciones distintas.

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

BUYER · CONSORTIUM_MEMBER · OTHER · SUPPLIER

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

ACTIVE · CANCELLED · INACTIVE · SUSPENDED · UNKNOWN

registrations array obligatorio

Inscripciones en los conjuntos de datos oficiales consultados; la cobertura no es exhaustiva.

Campos internos
registrations[].authority object obligatorio
Campos internos
registrations[].authority.country object obligatorio

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

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

ACTIVE · CANCELLED · INACTIVE · PENDING · SUSPENDED · UNKNOWN

registrations[].type object obligatorio

COMMERCIAL_REGISTRATION · OTHER · PUBLIC_PROCUREMENT_SUPPLIER · REGULATORY_REGISTRATION · TAX_REGISTRATION

relationships array obligatorio

Relaciones publicadas por las fuentes; no deduzcas propiedad no declarada.

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

Cargos y representación legal publicados; no determinan el beneficiario final.

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

Sanciones encontradas en las fuentes consultadas. Una lista vacía no acredita ausencia de sanciones.

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

ACTIVE · COMPLETED · EXPIRED · UNKNOWN

sanctions[].title union obligatorio
sanctions[].type string obligatorio
schema_version object obligatorio

Versión del contrato de respuesta; úsala para detectar cambios incompatibles.

1.0

sources array obligatorio

Conjuntos 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 obligatorio
Campos internos
sources[].coverage.from union obligatorio
sources[].coverage.to union obligatorio
sources[].data_as_of union obligatorio
sources[].dataset_name string obligatorio
sources[].expected_update_frequency object obligatorio

DAILY · MANUAL · MONTHLY · UNKNOWN · WEEKLY · YEARLY

sources[].freshness object obligatorio

CURRENT · DELAYED · STALE · UNKNOWN

sources[].id string obligatorio
sources[].last_imported_at union obligatorio
sources[].latest_observation_at union obligatorio
sources[].publisher_name string obligatorio
sources[].reporting_basis object obligatorio

COMPANY_DECLARED_TO_AUTHORITY · LATINFO_DERIVED · OFFICIAL_PUBLICATION · OFFICIAL_REGISTRY · THIRD_PARTY_DECLARED_TO_AUTHORITY

sources[].source_updated_at union obligatorio
sources[].verification_url union obligatorio
statuses array obligatorio

Observaciones de registros distintos. Conserva el ámbito, la etiqueta original y la evidencia; no deduzcas un dictamen global.

Campos internos
statuses[].code object obligatorio

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

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

COMMERCIAL_REGISTRATION · FACILITY · LEGAL_ENTITY · PROCUREMENT_SUPPLIER_REGISTRATION · REGULATORY_REGISTRATION · TAX_REGISTRATION

supervision array obligatorio

Observaciones de supervisión o inscripción sectorial de las autoridades consultadas.

Campos internos
supervision[].authority_name string obligatorio
supervision[].evidence_refs array obligatorio
supervision[].id string obligatorio
supervision[].registration_type string obligatorio
supervision[].status union obligatorio
Esquema 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
No se documentó un cuerpo de respuesta.
401Clave de api ausente o inválida
No se documentó un cuerpo de respuesta.
404Empresa no encontrada
No se documentó un cuerpo de respuesta.
429Límite de solicitudes excedido
No se documentó un cuerpo de respuesta.
501País aún no incorporado al contrato universal
No se documentó un cuerpo de respuesta.
503El comprobante vigente de disponibilidad semántica no está disponible o está desactualizado
No se documentó un cuerpo de respuesta.
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.