Ver um empregador

Um empregador com o certificado que assina por ele.

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

Autenticação Bearer es_…

Corpo Sem corpo

Sucesso 200 employer

Caminho

uuid uuid

obrigatório

O uuid do empregador.

Respostas

200 employer

O empregador em data.employer.

404 not_found

Não existe nesta empresa.

401 invalid_api_key

Chave ausente, inválida ou revogada.

Ver um empregador

GET /v1/employers/{uuid}

Você envia

GET sem corpo

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

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

Você recebe

employer · O empregador em data.employer.

not_found · Não existe nesta empresa.

invalid_api_key · Chave ausente, inválida ou revogada.

{  "status": "success",  "message": "employer",  "data": {    "employer": {      "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"    }  }}

{  "status": "error",  "message": "not_found",  "data": {    "errors": [      {        "field": null,        "code": "not_found",        "detail": "Empregador 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