Ver um certificado

Um certificado com a validade, os dias que faltam para vencer e quantos empregadores o usam.

GET https://integration.enviaesocial.com.br/v1/certificates/{uuid}

Autenticação Bearer es_…

Corpo Sem corpo

Sucesso 200 certificate

Caminho

uuid uuid

obrigatório

O uuid do certificado.

Respostas

200 certificate

O certificado em data.certificate.

404 not_found

Não existe nesta empresa.

401 invalid_api_key

Chave ausente, inválida ou revogada.

Ver um certificado

GET /v1/certificates/{uuid}

Você envia

GET sem corpo

curl "https://integration.enviaesocial.com.br/v1/certificates/{uuid}" \  -H "Authorization: Bearer $ENVIAESOCIAL_KEY"

$http = new GuzzleHttp\Client([    'base_uri' => 'https://integration.enviaesocial.com.br/v1/',    'headers'  => ['Authorization' => 'Bearer ' . getenv('ENVIAESOCIAL_KEY')],]); $response = $http->get('certificates/{uuid}');$result = json_decode($response->getBody(), true);

const res = await fetch('https://integration.enviaesocial.com.br/v1/certificates/{uuid}', {  headers: { Authorization: `Bearer ${process.env.ENVIAESOCIAL_KEY}` },});const { data } = await res.json();

import osimport requests auth = {"Authorization": f"Bearer {os.environ['ENVIAESOCIAL_KEY']}"} res = requests.get("https://integration.enviaesocial.com.br/v1/certificates/{uuid}", headers=auth)data = res.json()["data"]

using var http = new HttpClient { BaseAddress = new Uri("https://integration.enviaesocial.com.br/v1/") };http.DefaultRequestHeaders.Authorization =    new("Bearer", Environment.GetEnvironmentVariable("ENVIAESOCIAL_KEY")); var res = await http.GetAsync("certificates/{uuid}");var json = await res.Content.ReadAsStringAsync();

Você recebe

certificate · O certificado em data.certificate.

not_found · Não existe nesta empresa.

invalid_api_key · Chave ausente, inválida ou revogada.

{  "status": "success",  "message": "certificate",  "data": {    "certificate": {      "uuid": "3f2b9c1e-6a47-4d0b-8e15-2c9a7f3b1d60",      "holder": {        "name": "CONTABIL HORIZONTE LTDA",        "document": "11222444000198",        "document_type": "CNPJ"      },      "issuer": "AC EXEMPLO v5",      "fingerprint": "9C:41:7E:0B:22:D8:5F:A3:61:4C:9E:07:B2:13:F8:6D:3A:C5:90:11",      "valid_from": "2026-08-14T10:22:31-03:00",      "valid_until": "2027-08-14T10:22:31-03:00",      "expires_in_days": 301,      "status": "ACTIVE",      "replaced": false,      "revoked_at": null,      "last_used_at": "2026-10-17T14:33:41-03:00",      "employers_count": 3,      "created_at": "2026-08-20T09:15:02-03:00"    }  }}

{  "status": "error",  "message": "not_found",  "data": {    "errors": [      {        "field": null,        "code": "not_found",        "detail": "Certificado não encontrado."      }    ]  }}

{  "status": "error",  "message": "invalid_api_key",  "data": {    "errors": [      {        "field": null,        "code": "invalid_api_key",        "detail": "Chave de API ausente, inválida ou revogada."      }    ]  }}

integration.enviaesocial.com.br/v1