Universal company API · getUniversalCompany

Perfil universal de empresa en LATAM

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

Empieza aquí para consultar una empresa de Argentina, Bolivia, Brasil, Chile, Colombia, Ecuador, Paraguay o Perú. Elige el país e ingresa su identificador fiscal local (CUIT, CNPJ, RUT, NIT o RUC). Latinfo devuelve el mismo contrato en inglés, respaldado por evidencia. Las rutas anteriores de cada país siguen funcionando.

EV
Respuesta con evidencia

Latinfo identifica el conjunto de datos gubernamental de origen y conserva su evidencia y fecha cuando el publicador las proporciona. Verifica las decisiones relevantes con esa institución.

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 | BO | BR | CL | CO | EC | PE | PY>pathobligatorio

Código de país ISO 3166-1 alpha-2: AR, BO, BR, CL, CO, EC, PE o PY.

Example: CL
taxIdstringpathobligatorio

Identificador empresarial que usa el gobierno local: CUIT en Argentina, NIT en Bolivia y Colombia, CNPJ en Brasil, RUT en Chile o RUC en Ecuador, Paraguay y Perú. Se acepta puntuación.

Example: 89.862.200-2

Ejemplo de solicitud

curl https://api.latinfo.dev/v1/companies/CL/89.862.200-2 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Respuestas

200Perfil universal de empresa verificado
Content-Type: application/json
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

{
  "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"
    ]
  },
  "contacts": {
    "emails": [
      {
        "evidence_refs": [
          null
        ],
        "id": "string",
        "reporting_basis": "COMPANY_DECLARED_TO_AUTHORITY",
        "role": "COMPANY_CONTACT",
        "value": "string",
        "verification": "NOT_INDEPENDENTLY_VERIFIED"
      }
    ],
    "phones": [
      {
        "country_calling_code": null,
        "evidence_refs": [
          null
        ],
        "format": "E164",
        "id": "string",
        "raw_value": "string",
        "reporting_basis": "COMPANY_DECLARED_TO_AUTHORITY",
        "role": "COMPANY_CONTACT",
        "type": "LANDLINE",
        "value": "string",
        "verification": "NOT_INDEPENDENTLY_VERIFIED"
      }
    ],
    "websites": [
      {
        "domain": "string",
        "evidence_refs": [
          null
        ],
        "id": "string",
        "reporting_basis": "COMPANY_DECLARED_TO_AUTHORITY",
        "url": "string",
        "verification": "NOT_INDEPENDENTLY_VERIFIED"
      }
    ]
  },
  "coverage": {
    "activities": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "addresses": {
      "data_as_of": "string",
      "sources_checked": [
        "string"
      ],
      "status": "AVAILABLE"
    },
    "contacts": {
      "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": "string",
      "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": "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.