Listar certificados

Lista os certificados da empresa, com paginação, dos que vencem por último aos que vencem primeiro. Sem filtro, vêm os ativos; procure pelo titular.

GET https://integration.enviaesocial.com.br/v1/certificates

Autenticação Bearer es_…

Corpo Sem corpo

Sucesso 200 certificates

Filtros na URL

status texto

opcional

ACTIVE (o padrão) ou REVOKED.

search texto

opcional

Nome ou documento do titular, até 100 caracteres.

page número

opcional

A página, a partir de 1 (padrão 1).

per_page número

opcional

Itens por página, de 1 a 100 (padrão 20).

Respostas

200 certificates

A lista em data.items e a paginação em data.pagination.

422 validation_error

Filtro inválido; o field diz qual. Nada é corrigido em silêncio.

401 invalid_api_key

Chave ausente, inválida ou revogada.

Listar certificados

GET /v1/certificates

Você envia

GET sem corpo

curl "https://integration.enviaesocial.com.br/v1/certificates" \  -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');$result = json_decode($response->getBody(), true);

const res = await fetch('https://integration.enviaesocial.com.br/v1/certificates', {  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", 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");var json = await res.Content.ReadAsStringAsync();

Você recebe

certificates · A lista em data.items e a paginação em data.pagination.

validation_error · Filtro inválido; o field diz qual. Nada é corrigido em silêncio.

invalid_api_key · Chave ausente, inválida ou revogada.

{  "status": "success",  "message": "certificates",  "data": {    "items": [      {        "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"      }    ],    "pagination": {      "page": 1,      "per_page": 20,      "total": 1,      "total_pages": 1,      "has_next": false,      "has_prev": false,      "next_page": null,      "prev_page": null    }  }}

{  "status": "error",  "message": "validation_error",  "data": {    "errors": [      {        "field": "status",        "code": "invalid",        "detail": "Use ACTIVE ou REVOKED."      }    ]  }}

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