Pular para o conteúdo
notemnotemDocumentação

Referência da API › Certificado

Consultar certificado

Mostra os dados do certificado digital ativo, como titular e validade.

GET/api/v1/empresas/{id}/certificado

Use para saber quando o certificado vence e trocá-lo a tempo. O arquivo e a senha nunca são devolvidos.

Sem certificado cadastrado, a resposta é 404.

Parâmetros

idtextono caminhoobrigatório
Empresa da organização da chave (de outra organização → 404). UUID (RFC 9562); fora do padrão → 400 REQUISICAO_INVALIDA com campo id. · UUID

Respostas

200 Certificado

Campos da resposta
titulartexto
cnpjtexto
CNPJ de 14 posições, numérico ou alfanumérico (12 posições 0-9/A-Z + 2 dígitos verificadores). Na entrada, máscara e minúsculas são aceitas e normalizadas; nas respostas vem sempre com 14 caracteres maiúsculos, sem máscara. · até 18 caracteres
emissortexto
numero_serietexto
valido_detexto
data e hora ISO 8601
valido_atetexto
data e hora ISO 8601
situacaotexto
Valores: valido, vencendo, vencido
dias_para_vencerinteiro

404 Erro no formato padrão

Limites

Valem também os limites gerais da chave. Veja Limites de uso.