Skip to main content
Salú is an occupational health and safety (OHS) platform. The public API lets client systems (ERP, payroll, HR) maintain the company structure and employees in a secure, traceable way — and, from there, the occupational exam lifecycle (ASO, the Brazilian Occupational Health Certificate).
If you haven’t yet, start with How to use: environments, x-api-key authentication, pagination and errors.

​
Core entities

​
How they relate

In words:
  • An Organization owns Branches, Sectors and Positions.
  • A Branch + a Sector + a Position form a Hierarchy — the “position” an employee is assigned to. This combination defines the occupational risks and therefore the required exams.
  • An Employee links a Person (identified by CPF) to the organization, in a Hierarchy. Each action on the employee (hiring, dismissal, periodic, return, risk change) generates an exam pendency.
  • The Pendency tracks the exam until completion (ASO issued) or cancellation. Scheduling at a clinic and performing the exam are orchestrated internally by Salú.
Schedule and Clinic appear in the diagram to explain the exam lifecycle, but they have no public endpoints — they are managed inside the Salú platform. The public API exposes the resources marked in the table above.

​
Next steps

Set up the company structure

Create Branches, Sectors and Positions before registering employees.

Employee onboarding

Register the employee and generate the hiring exam.