List Employees

Public List Employees

curl --request GET \
  --url https://public-api.salu.com.vc/dev/routes/v0/employee/ \
  --header 'x-api-key: <api-key>'

import requests

url = "https://public-api.salu.com.vc/dev/routes/v0/employee/"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://public-api.salu.com.vc/dev/routes/v0/employee/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.salu.com.vc/dev/routes/v0/employee/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.salu.com.vc/dev/routes/v0/employee/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://public-api.salu.com.vc/dev/routes/v0/employee/")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.salu.com.vc/dev/routes/v0/employee/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "is_disabled": true,
      "status": "<string>",
      "sex": "<string>",
      "admission_date": "2023-12-25",
      "is_active": true,
      "organization": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      },
      "branch": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      },
      "position": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      },
      "sector": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      },
      "social_name": "<string>",
      "gov_id": "<string>",
      "birth_date": "2023-12-25",
      "gender": "<string>",
      "mother_name": "<string>",
      "marital_status": "<string>",
      "place_of_birth": "<string>",
      "educational_stage": "<string>",
      "human_skin_tone": "<string>",
      "phone": "<string>",
      "cell_phone": "<string>",
      "email": "<string>",
      "personal_email": "<string>",
      "dismissal_date": "2023-12-25",
      "hr_code": "<string>",
      "employee_registration_number": "<string>",
      "work_shift": "<string>",
      "client_integration_code": "<string>",
      "address": {
        "address": "<string>",
        "address_number": "<string>",
        "address_detail": "<string>",
        "zip_code": "<string>",
        "neighborhood": "<string>",
        "state": "<string>",
        "city": "<string>"
      }
    }
  ],
  "cursor": {
    "total": 123,
    "page": 123,
    "page_size": 123,
    "total_pages": 123,
    "next_page": true
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

GET

employee

Public List Employees

curl --request GET \
  --url https://public-api.salu.com.vc/dev/routes/v0/employee/ \
  --header 'x-api-key: <api-key>'

import requests

url = "https://public-api.salu.com.vc/dev/routes/v0/employee/"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://public-api.salu.com.vc/dev/routes/v0/employee/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.salu.com.vc/dev/routes/v0/employee/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.salu.com.vc/dev/routes/v0/employee/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://public-api.salu.com.vc/dev/routes/v0/employee/")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.salu.com.vc/dev/routes/v0/employee/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "is_disabled": true,
      "status": "<string>",
      "sex": "<string>",
      "admission_date": "2023-12-25",
      "is_active": true,
      "organization": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      },
      "branch": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      },
      "position": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      },
      "sector": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      },
      "social_name": "<string>",
      "gov_id": "<string>",
      "birth_date": "2023-12-25",
      "gender": "<string>",
      "mother_name": "<string>",
      "marital_status": "<string>",
      "place_of_birth": "<string>",
      "educational_stage": "<string>",
      "human_skin_tone": "<string>",
      "phone": "<string>",
      "cell_phone": "<string>",
      "email": "<string>",
      "personal_email": "<string>",
      "dismissal_date": "2023-12-25",
      "hr_code": "<string>",
      "employee_registration_number": "<string>",
      "work_shift": "<string>",
      "client_integration_code": "<string>",
      "address": {
        "address": "<string>",
        "address_number": "<string>",
        "address_detail": "<string>",
        "zip_code": "<string>",
        "neighborhood": "<string>",
        "state": "<string>",
        "city": "<string>"
      }
    }
  ],
  "cursor": {
    "total": 123,
    "page": 123,
    "page_size": 123,
    "total_pages": 123,
    "next_page": true
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

This endpoint returns a list of employees. The response is an array of PublicApiEmployeeBaseResponse.

Overview

Method: GET
Path: /v0/employee/
OperationId: public_list_employees_v0_employee__get
Authentication: header x-api-key (APIKeyHeader in the OpenAPI)

Query parameters (main)

page (default: 0)
limit (default: 20)
order_by (default: name,status) — supports multiple fields separated by commas
order_dir (default: asc,desc) — directions correspond to the fields in order_by
is_active (default: true)
is_disabled (optional)
name, gov_id (CPF), email
status[] (list of allowed values from StatusEnumFilter)
position_id, sector_id (UUID)
branch_id[], organization_id[], id[] (UUID lists)
birth_date, admission_date, dismissal_date (format YYYY-MM-DD)
client_integration_code (optional)

Tips and common pitfalls

Status filter: the API expects the Portuguese enum strings for status[] (e.g., Ativo, Pendente), even when using the EN docs. Do not send English words like ACTIVE.
Multiple values: you can repeat a query param to send multiple values (e.g., &status=Ativo&status=Pendente), or use array-friendly notation depending on your HTTP client.
Ordering: order_by and order_dir are positional — the first direction applies to the first field, and so on. If only one direction is sent, it applies to all listed fields.
UUIDs: fields like id, branch_id, sector_id, organization_id must be valid UUIDs; otherwise the API may return 400 Bad Request.
Pagination: combine page and limit to control the result window; defaults are shown above.

Example Request

curl -X GET "https://public-api.salu.com.vc/dev/routes/v0/employee/?page=0&limit=20&order_by=name,status&order_dir=asc,desc&is_active=true&name=Maria&branch_id=11111111-1111-1111-1111-111111111111&status=ACTIVE&status=PENDING" \
  -H "Accept: application/json" \
  -H "x-api-key: $SALU_PUBLIC_API_KEY"

Authorizations

x-api-key

string

header

required

Query Parameters

is_active

default:true

order_by

string

default:name,status

order_dir

string

default:asc,desc

page

integer

default:0

limit

integer

default:20

name

string | null

gov_id

string | null

status

enum<string>[] | null

Available options:

Ativo,

Inativo,

Afastado,

Férias,

Pendente

position_id

string<uuid> | null

sector_id

string<uuid> | null

branch_id

string<uuid>[] | null

organization_id

string<uuid>[] | null

birth_date

string<date> | null

admission_date

string<date> | null

dismissal_date

string<date> | null

client_integration_code

string | null

updated_after

string<date-time> | null

is_disabled

boolean | null

Response

Successful Response

data

PublicApiEmployeeBaseResponse · object[]

required

Show child attributes

cursor

PaginateCursor · object | null

required

Show child attributes

Update Sector Get Employee

Início

PT-BR

EN

Overview

Query parameters (main)

Example Request

Authorizations

Query Parameters

Response

​Overview

​Query parameters (main)

​Example Request

Authorizations

Query Parameters

Response

Overview

Query parameters (main)

Example Request