Skip to main content
GET
/
v0
/
employee
List Employees
curl --request GET \
  --url https://public-api.salu.com.vc/dev/routes/v0/employee/ \
  --header 'x-api-key: <api-key>'
{
  "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
  }
}
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
​
email
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
​
id
string<uuid>[] | null
​
birth_date
string<date> | null
​
admission_date
string<date> | null
​
dismissal_date
string<date> | null
​
client_integration_code
string | null
​
is_disabled
boolean | null

Response

Successful Response

​
data
PublicApiEmployeeBaseResponse · object[]
required
​
cursor
PaginateCursor · object
required