API
Consulta programática de NIF — para facturação, CRMs, onboarding de clientes.
Endpoint público (rate-limited por IP)
GET https://ao.nif.amoes.7999.cloud/api/v1/lookup/5002169088
Sem autenticação, até 30 consultas/hora por IP. Útil para testes e uso esporádico.
Endpoint autenticado (API key)
GET https://amoes.7999.cloud/api/hub/public/contribuinte/5002169088
X-Api-Key: amsk_...
Rate limit configurável por subscriber. Para obter uma chave, escreve para nif@uhasi.ao.
Resposta
{
"nif": "5002169088",
"nome": "UHASI-COMÉRCIO E SERVIÇOS",
"tipo": "COLECTIVO - Empresa",
"estado": "Activo",
"regime_iva": "Não",
"confianca": "agt"
}
Campo confianca
- agt — dados obtidos directamente do portal AGT
- verificado — revistos manualmente por um operador
- manual — inseridos por utilizador
- existente — provêm de registos internos anteriores
- mock — dados simulados (só em ambiente dev)