{
"status": "ok",
"service": "Subjectum — Company Registry & KYB Verification API"
}
curl --location --request GET 'https://zylalabs.com/api/13807/subjectum+company+registry++kyb+api/31658/healthz' --header 'Authorization: Bearer YOUR_API_KEY'
{
"query": {
"ico": "27074358",
"country_hint": "CZ"
},
"company": {
"name": "Asseco Central Europe, a.s.",
"ico": "27074358",
"dic": "CZ27074358",
"ic_dph": "CZ27074358",
"legal_form": "Akciová spoločnosť",
"address": {
"street": "Budějovická 778",
"city": "Praha",
"zip": "14000",
"country": "Česká republika"
},
"founded_date": "2003-08-06",
"status": "ACTIVE",
"statutory_representatives": []
},
"risk_flags": {
"newly_founded": false,
"recent_address_change": false,
"recent_representative_change": false,
"insolvency_related": false,
"risk_score": 0
},
"metadata": {
"data_source": "ARES",
"source_last_updated": "2026-09-03",
"confidence_score": 1,
"country": "CZ"
}
}
curl --location --request GET 'https://zylalabs.com/api/13807/subjectum+company+registry++kyb+api/31660/lookup-company?ico=27074358&country=CZ' --header 'Authorization: Bearer YOUR_API_KEY'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Registro da Empresa Subjectum KYB API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento.
Subjectum é uma API REST sem cabeçalho para verificação Know Your Business (KYB) e consultas de registro de empresas em toda a Europa Central
Envie um número de registro de empresa (IČO) e receba dados normalizados e estruturados extraídos diretamente de registros oficiais do governo — sem pesquisa manual, sem scraping, sem formatos inconsistentes entre países
Atualmente suportado:
- República Checa — via ARES (Administrativní registr ekonomických subjektů), o registro oficial de empresas da Checa
- Eslováquia — via RPO (Register právnických osob), o registro oficial de empresas da Eslováquia
Cada resposta inclui:
- Dados da empresa normalizados: nome legal, número de registro, ID fiscal (DIČ/IČ DPH), forma legal, endereço registrado, data de fundação e status legal atual
- Representantes legais quando disponíveis na fonte do registro
- Sinais de risco automatizados: empresa recém-fundada (menos de 6 meses), status de liquidação, status de falência e pontuação de confiança
- Atribuição explícita da fonte de dados e carimbo de data/hora da última atualização para cada consulta, para que você saiba exatamente de onde os dados vieram e quão recentes são
Casos de uso: verificações automatizadas de onboarding KYB/AML, diligência devida de fornecedores e vendedores, prevenção de fraudes B2B, enriquecimento de CRM e fluxos de trabalho de conformidade que precisam de dados de empresas verificados em vez de informações autorreportadas
O suporte para a Polônia e a Hungria está previsto para um lançamento futuro por meio de parceiros de dados comerciais. Solicitações para esses países atualmente retornam uma resposta clara e legível por máquina de "ainda não suportado" em vez de falhar silenciosamente
Construído no FastAPI com validação de esquema rigorosa — cada resposta é garantida para corresponder à estrutura documentada
A API retorna dados normalizados da empresa, incluindo nome legal, número de registro, CPF, forma jurídica, endereço registrado, data de fundação e status legal atual. Também fornece representantes estatutários e sinalizadores de risco automatizados indicando status de recém-fundado, liquidação e falência
Os campos-chave na resposta incluem "nome", "ico", "dic", "forma_jurídica", "endereço", "data_de_fundação", "status" e "flags_de_risco" Cada campo fornece informações essenciais sobre a empresa e sua situação legal
A resposta está estruturada em um formato JSON com seções distintas: "query" para parâmetros de entrada, "company" para detalhes da empresa, "risk_flags" para avaliações de risco e "metadata" para fonte de dados e pontuação de confiança. Essa organização facilita a análise e utilização.
Os dados são provenientes diretamente de registros oficiais do governo: ARES para a República Tcheca e RPO para a Eslováquia Isso garante que as informações sejam precisas e atualizadas refletindo os últimos status legais
A precisão dos dados é mantida por meio de integração direta com registros oficiais garantindo atualizações em tempo real Cada resposta inclui um carimbo de data/hora "source_last_updated" permitindo que os usuários verifiquem a atualidade dos dados
Casos de uso típicos incluem verificações automatizadas de integração de KYB/AML, diligência devida de fornecedores e fornecedores, prevenção de fraudes B2B e enriquecimento de CRM A API fornece dados de empresas verificados essenciais para fluxos de trabalho de conformidade
Os usuários podem personalizar solicitações especificando o número de registro da empresa (IČO) e, opcionalmente, fornecendo uma "dica de país" para indicar o registro desejado Isso permite buscas direcionadas na República Checa ou na Eslováquia
Se uma busca não retornar resultados, a API fornecerá uma resposta clara indicando que a empresa não foi encontrada Os usuários devem implementar verificações para resultados vazios para lidar com esses cenários de forma elegante em suas aplicações