Listar empregadores

Lista os empregadores em ordem de nome, com paginação. Filtre por nome, documento ou pelo certificado que assina por eles.

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

Autenticação Bearer es_…

Corpo Sem corpo

Sucesso 200 employers

Filtros na URL

search texto

opcional

Nome ou documento.

certificate uuid

opcional

Só os empregadores deste certificado.

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 employers

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

422 validation_error

Página ou itens por página inválidos; o field diz qual.

401 invalid_api_key

Chave ausente, inválida ou revogada.

Listar empregadores

GET /v1/employers

Você envia

GET sem corpo

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

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

Você recebe

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

validation_error · Página ou itens por página inválidos; o field diz qual.

invalid_api_key · Chave ausente, inválida ou revogada.

{  "status": "success",  "message": "employers",  "data": {    "items": [      {        "uuid": "a81d3e5c-0f2b-4c69-9d17-5e6b4a2c8f03",        "document_type": "CNPJ",        "document": "11222333000181",        "name": "Padaria Pão Dourado Ltda",        "link_type": "PROXY",        "certificate": {          "uuid": "3f2b9c1e-6a47-4d0b-8e15-2c9a7f3b1d60",          "holder": {            "name": "CONTABIL HORIZONTE LTDA",            "document": "11222444000198",            "document_type": "CNPJ"          },          "valid_until": "2027-08-14T10:22:31-03:00"        },        "created_at": "2026-10-17T14:20:05-03:00",        "updated_at": "2026-10-17T14:20:05-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": "per_page",        "code": "min",        "detail": "Use um número inteiro de 1 a 100."      }    ]  }}

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