Universal company API · getUniversalCompany

Perfil universal de empresa na LATAM

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

Comece aqui para consultar uma empresa da Argentina, Bolívia, Brasil, Chile, Colômbia, Equador, Paraguai ou Peru. Escolha o país e informe seu identificador fiscal local (CUIT, CNPJ, RUT, NIT ou RUC). O Latinfo retorna o mesmo contrato em inglês, respaldado por evidências. As rotas anteriores de cada país continuam funcionando.

EV
Resposta com evidências

O Latinfo identifica o conjunto de dados governamental de origem e preserva suas evidências e data quando disponibilizadas. Verifique decisões relevantes com essa instituição.

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

Parâmetros

countryenum<AR | BO | BR | CL | CO | EC | PE | PY>pathobrigatório

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

Example: CL
taxIdstringpathobrigatório

Identificador empresarial usado pelo governo local: CUIT na Argentina, NIT na Bolívia e Colômbia, CNPJ no Brasil, RUT no Chile ou RUC no Equador, Paraguai e Peru. A pontuação é aceita.

Example: 89.862.200-2

Exemplo de requisição

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

Respostas

200Perfil universal de empresa verificado
Content-Type: application/json
400Identificador fiscal inválido para o país
Nenhum corpo de resposta documentado.
401Chave de api ausente ou inválida
Nenhum corpo de resposta documentado.
404Empresa não encontrada
Nenhum corpo de resposta documentado.
429Limite de requisições excedido
Nenhum corpo de resposta documentado.
501País ainda não incorporado ao contrato universal
Nenhum corpo de resposta documentado.
503O comprovante vigente de disponibilidade semântica está indisponível ou desatualizado
Nenhum corpo de resposta documentado.

Exemplo JSON

{
  "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"
}

Procedência e limitações

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